Skip to main content
The Motus agent server exposes a REST API for managing conversations with your agent. Start a server with motus serve start, then interact with it over HTTP. All endpoints are served from the base URL of your running server (e.g., http://localhost:8000).

Endpoints

EndpointMethodDescription
/healthGETServer health check with worker and session counts
/sessionsPOSTCreate a new conversation session
/sessions/{id}PUTCreate a session with a client-specified ID
/sessionsGETList all active sessions
/sessions/{id}GETGet session details (supports long-polling)
/sessions/{id}DELETEDelete a session and free resources
/sessions/{id}/messagesPOSTSend a message to a session
/sessions/{id}/messagesGETRetrieve conversation history

Guides

TopicDescription
SessionsSession lifecycle — create, inspect, poll, and delete
MessagesSend messages and retrieve conversation history
WebhooksReceive turn results via HTTP callback instead of polling