Skip to main content

Endpoint

The agent keeps the earlier context of the conversation, so ask the follow-up as you would ask a person - there is no need to repeat the whole question.

Authentication

This endpoint requires an OAuth access token. Send it as a bearer token:
Required scope: agent:write The agent runs as the access token’s user and inherits exactly that user’s access.

Path Parameters

You can continue a conversation this API started, or one the same user started in the Chamelio web app. Conversations that belong to other surfaces (such as the Word add-in or a workflow) return 404.

Query Parameters

Request Body

Follow-up messages cannot turn on web search. Web search is only set when the conversation starts (use_web on Ask the Agent).

Request Example

Response

The response has the same shape as Ask the Agent: a Server-Sent Events stream by default, or a single JSON body with stream=false.

Success Response (stream=false)

Status Code: 200 OK
See Response Fields for every field.
With stream=false, session_id is always the conversation from the path. When streaming, a follow-up run does not send a new session_id event - keep using the one you already have.

Error Responses

400 Bad Request

Returned when the access token has no user behind it. client_credentials tokens act as the admin who created the application, so this applies only to tokens issued before application creators were recorded.

401 Unauthorized

Returned when the access token is missing, unknown, revoked, or expired, or when an X-API-Key was sent instead of a bearer token. See OAuth error responses.

403 Forbidden

Returned when the token does not carry the required scope.

404 Not Found

Returned when the conversation does not exist, or belongs to a surface this API cannot drive (such as the Word add-in or a workflow). Both cases return the same response on purpose.

409 Conflict

Returned when a run is already active on this conversation. Wait for it to finish, then send your message. The detail is passed through from the agent service.

422 Validation Error

Returned when the request is invalid, for example an empty prompt or a session_id that is not a UUID.

429 Too Many Requests

Returned when your organization exceeds its per-minute request limit.

500 Internal Server Error

Returned when the run could not be started or failed before producing an answer.