Sign in

v47

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-181,0851,7264.5 MB
Assistants

Assistant Chat (BETA)

This endpoint allows a client to send a chat message to a specific AI Assistant. The assistant processes the message and returns a relevant reply based on the current conversation context. Refer to the Conversation API to create a conversation, filter existing conversations, fetch messages for a conversation, and manually add messages to a conversation.

post/ai/assistants/{assistant_id}/chat

Path parameters

assistant_idstring required

Unique identifier of the assistant.

Request body

contentstring required

The message content sent by the client to the assistant

namestring

The optional display name of the user sending the message

conversation_idstring required

A unique identifier for the conversation thread, used to maintain context

Example request

{
  "content": "Tell me a joke about cats",
  "name": "Charlie",
  "conversation_id": "42b20469-1215-4a9a-8964-c36f66b406f4"
}

Response

Successful Response

contentstring required

The assistant's generated response based on the input message and context.

Example response

{
  "content": "Why did the cat sit on the computer? Because it wanted to keep an eye on the mouse!"
}