Overview - Motus

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

Endpoint	Method	Description
`/health`	`GET`	Server health check with worker and session counts
`/sessions`	`POST`	Create a new conversation session
`/sessions/{id}`	`PUT`	Create a session with a client-specified ID
`/sessions`	`GET`	List all active sessions
`/sessions/{id}`	`GET`	Get session details (supports long-polling)
`/sessions/{id}`	`DELETE`	Delete a session and free resources
`/sessions/{id}/messages`	`POST`	Send a message to a session
`/sessions/{id}/messages`	`GET`	Retrieve conversation history

Guides

Topic	Description
Sessions	Session lifecycle — create, inspect, poll, and delete
Messages	Send messages and retrieve conversation history
Webhooks	Receive turn results via HTTP callback instead of polling

​Endpoints

​Guides

Endpoints

Guides