Send a message to an agent
The Conversation Service for Agents, identical in contract to the App one: send message, get a reply; pass back conversation_id to continue the same conversation (history is kept server-side, never resent); stream: true answers as Server-Sent Events with the run's event stream. Runs the Agent's PUBLISHED version and spends the organization's credits. Requires the agents:execute scope.
Authorization
apiKey An organization API key, created from a Portal's Webhooks page (Provisioning API card). The secret is shown once at creation and stored only as a hash. Keys are organization-wide and carry scopes (end_users:read, end_users:write). Rate limit: 120 requests per minute per key (sliding 60-second window).
In: header
Path Parameters
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/agents/497f6eca-6276-4993-bfeb-53cbbbba6f08/conversation" \ -H "Content-Type: application/json" \ -d '{ "message": "string" }'{ "reply": "string", "conversation_id": "cc71b11a-25cd-4c2d-9950-df2cc38e3407"}