Endpoint
Authentication
This endpoint requires an OAuth access token. Send it as a bearer token: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 withstream=false.
Success Response (stream=false)
Status Code: 200 OK
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 anX-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. Thedetail is passed through from the agent service.
422 Validation Error
Returned when the request is invalid, for example an emptyprompt or a session_id that is not a
UUID.