Last updated 2 months ago
The Bearer Token is the TOOLHOUSE_API_KEY. You can find your API key(s) .
GET /v1/agent-runs/{run_id} HTTP/1.1 Host: Authorization: Bearer YOUR_SECRET_TOKEN Accept: */*
Successful Response
{ "data": { "id": "123e4567-e89b-12d3-a456-426614174000", "chat_id": "123e4567-e89b-12d3-a456-426614174000", "schedule_id": "123e4567-e89b-12d3-a456-426614174000", "results": [ {} ], "status": "queued", "created_at": "2025-06-04T20:15:09.139Z", "updated_at": "2025-06-04T20:15:09.139Z", "bundle": "default", "toolhouse_id": "default", "vars": { "ANY_ADDITIONAL_PROPERTY": "text" }, "callback_url": "https://example.com", "last_agent_message": "text" } }
GET /v1/agent-runs HTTP/1.1 Host: Authorization: Bearer YOUR_SECRET_TOKEN Accept: */*
{ "data": [ { "id": "123e4567-e89b-12d3-a456-426614174000", "chat_id": "123e4567-e89b-12d3-a456-426614174000", "user_id": "text", "schedule_id": "123e4567-e89b-12d3-a456-426614174000", "status": "queued", "results": [ {} ], "created_at": "2025-06-04T20:15:09.139Z", "updated_at": "2025-06-04T20:15:09.139Z", "bundle": "default", "toolhouse_id": "default", "vars": { "ANY_ADDITIONAL_PROPERTY": "text" }, "callback_url": "https://example.com", "mcp_servers": [ "text" ] } ] }
default
POST /v1/agent-runs HTTP/1.1 Host: Authorization: Bearer YOUR_SECRET_TOKEN Content-Type: application/json Accept: */* Content-Length: 226 { "chat_id": "123e4567-e89b-12d3-a456-426614174000", "schedule_id": "123e4567-e89b-12d3-a456-426614174000", "bundle": "default", "toolhouse_id": "default", "vars": { "ANY_ADDITIONAL_PROPERTY": "text" }, "callback_url": "https://example.com" }
No content
PUT /v1/agent-runs/{run_id} HTTP/1.1 Host: Authorization: Bearer YOUR_SECRET_TOKEN Content-Type: application/json Accept: */* Content-Length: 18 { "message": "text" }