Connect to event stream
Open a persistent SSE connection to receive events for a session.text/event-stream. See Streaming for event types.
Send message
Response:
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Send messages, stream agent events, approve tools, and manage active runs.
curl -N http://localhost:6877/chat/events/{session_id} \
-H "Authorization: Bearer $API_KEY"
text/event-stream. See Streaming for event types.
curl -X POST http://localhost:6877/chat/message \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"message": "What meetings do I have today?", "session_id": "abc-123"}'
| Field | Type | Description |
|---|---|---|
message | string | User message |
session_id | string | Target session |
images | array | Optional base64 image attachments |
skip_approvals | boolean | Auto-approve all tool calls for this run |
{"run_id": "run_abc", "session_id": "abc-123"}
curl -X POST http://localhost:6877/tools/result \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"run_id": "run_abc",
"tool_id": "tc_abc123",
"result": "Approved",
"approved": true
}'
curl -X POST http://localhost:6877/chat/background \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"run_id": "run_abc"}'
curl -X POST http://localhost:6877/cancel \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"run_id":"run_abc"}'
{"session_id":"abc-123"}
curl -X POST http://localhost:6877/chat/subagents/{tool_call_id}/cancel \
-H "Authorization: Bearer $API_KEY"
curl -X DELETE http://localhost:6877/chat/inject/{client_id} \
-H "Authorization: Bearer $API_KEY"
curl http://localhost:6877/chat/runs/status \
-H "Authorization: Bearer $API_KEY"
curl http://localhost:6877/chat/{session_id}/workflows \
-H "Authorization: Bearer $API_KEY"
curl http://localhost:6877/chat/background-tasks \
-H "Authorization: Bearer $API_KEY"
curl -X POST http://localhost:6877/chat/background-tasks/{task_id}/cancel \
-H "Authorization: Bearer $API_KEY"
curl http://localhost:6877/chat/child-agents \
-H "Authorization: Bearer $API_KEY"
curl http://localhost:6877/chat/child-agents/{child_run_id}/result \
-H "Authorization: Bearer $API_KEY"
curl -X POST http://localhost:6877/chat/child-agents/{child_run_id}/cancel \
-H "Authorization: Bearer $API_KEY"
curl -X POST http://localhost:6877/chat/child-agents/{child_run_id}/inject \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"message":"extra context"}'
curl http://localhost:6877/context \
-H "Authorization: Bearer $API_KEY"
curl -X POST http://localhost:6877/compact \
-H "Authorization: Bearer $API_KEY"