Skip to main content
Get details for a session. Supports long-polling so you can block until a running turn completes. This maps directly to GET /sessions/{id} described in the Sessions API reference.

Usage

motus serve get <url> <id> [options]

Options

FlagDefaultDescription
--waitfalseBlock until the session is no longer "running"
--timeoutMaximum seconds to wait (only applies with --wait)

Examples

Get session details

motus serve get http://localhost:8000 550e8400-e29b-41d4-a716-446655440000

Long-poll until complete

motus serve get http://localhost:8000 550e8400-e29b-41d4-a716-446655440000 --wait --timeout 30
{
  "session_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "idle",
  "response": { "role": "assistant", "content": "hi there" }
}