REST APIMessages
Send a message (start a turn)
Accepts the request immediately (202) and runs the turn asynchronously — consume progress from the events SSE endpoint.
Authorization
ApiKey x-api-key<token>
Workspace-owned API key with per-resource permissions.
In: header
Path Parameters
id*string
Format
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
content*string
model?string
Length
1 <= length <= 64effort?string
Length
1 <= length <= 64attachmentIds?array<>
Items
items <= 20skillNames?array<>
Items
items <= 3idempotencyKey?string
Length
1 <= length <= 128Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/messages" \ -H "Content-Type: application/json" \ -d '{ "content": "string" }'{ "messageId": "8540d774-4863-4d2b-b788-4ecb19412e85", "status": "queued"}