Sign in
Assistant

Send an assistant message

Sends a follow-up message to an existing assistant chat started with POST /v1/assistants. Asynchronous: the response contains the messageId of the assistant's pending reply. Poll GET /v1/assistant-messages/{messageId} until status is terminal, or subscribe to assistant_message.* webhooks.

post/v1/assistants/{assistantId}/messages

Path parameters

assistantIdstring required

The assistant chat id (e.g. vg_asst_...). Every API project has one assistant chat; find it on ProjectResponse.assistantId.

Request body

messagestring required

The message to send to the assistant in this project chat.

Example request

{
  "message": "Make it more upbeat and add captions"
}

Response

Assistant message accepted.

messageIdstring required

Opaque assistant message id for the pending assistant reply (e.g. vg_mesg_...). Poll GET /v1/assistant-messages/{messageId}.

Changes

No recorded changes to this endpoint across all 1 revision of this API.