Chats

Create, list, and retrieve chats via the v1 API.

Chats represent conversations with the orchestrator. Each chat belongs to a workspace and contains a sequence of user and assistant messages.

POST /api/v1/chats

Create a new chat

curl -X POST http://localhost:3000/api/v1/chats \
  -H "Authorization: Bearer op_api_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"agentType": "orchestrator"}'

Response: 201 with the created chat object.

GET /api/v1/chats

List chats in a workspace

curl http://localhost:3000/api/v1/chats?page=1&pageSize=20 \
  -H "Authorization: Bearer op_api_your_key_here"

GET /api/v1/chats/:chatId

Get a single chat by ID

curl http://localhost:3000/api/v1/chats/f216fd8d-43b6-48aa-976b-af88227f86c3 \
  -H "Authorization: Bearer op_api_your_key_here"

Response: {"chat": {...}} — the chat object contains:

• id: the unique identifier of the chat.
• title: the generated title of the conversation.
• status: tracks the overall state of the chat ("idle", "pending", "processing", "completed", "failed", or "stopped").
• createdAt & updatedAt: timestamps of when the chat was created and last updated.

Error Responses