HTTP routes

The client methods map to the Cursor Cloud Agents API base URL https://api.cursor.com (paths under /v0). Async methods are identical but must be awaited.

Client method

HTTP

SyncClient.me() / AsyncClient.me()

GET /v0/me

SyncClient.list_models() / AsyncClient.list_models()

GET /v0/models

SyncClient.list_repositories() / AsyncClient.list_repositories()

GET /v0/repositories

SyncClient.list_agents() / AsyncClient.list_agents()

GET /v0/agents

SyncClient.get_agent() / AsyncClient.get_agent()

GET /v0/agents/{id}

SyncClient.get_conversation() / AsyncClient.get_conversation()

GET /v0/agents/{id}/conversation

SyncClient.launch_agent() / AsyncClient.launch_agent()

POST /v0/agents

SyncClient.followup() / AsyncClient.followup()

POST /v0/agents/{id}/followup

SyncClient.stop_agent() / AsyncClient.stop_agent()

POST /v0/agents/{id}/stop

SyncClient.delete_agent() / AsyncClient.delete_agent()

DELETE /v0/agents/{id}

High-level Agent.create() and Agent.follow_up() call launch_agent and followup respectively, while keeping the agent id on the handle.