---
title: "Send a message to the assistant"
method: POST
path: "/v1/Assistants/{id}/Messages"
---

# Send a message to the assistant

`POST /v1/Assistants/{id}/Messages`

## Request

- Base URL: `https://assistants.twilio.com`
- URL: `https://assistants.twilio.com/v1/Assistants/{id}/Messages`
- Auth: HTTP basic

send a message

## Path parameters

- `id` string, required

## Request body

- AssistantsV1ServiceAssistantSendMessageRequest
  - `identity` string, required: The unique identity of user for the session.
  - `session_id` string: The unique name for the session.
  - `body` string, required: The query to ask the assistant.
  - `webhook` string: The webhook url to call after the assistant has generated a response or report an error.
  - `mode` string: one of the modes 'chat', 'email' or 'voice'

## Response `200`

OK

- AssistantsV1ServiceAssistantSendMessageResponse
  - `status` string, required: success or failure based on whether the request successfully generated a response.
  - `flagged` boolean: If successful, this property will denote whether the response was flagged or not.
  - `aborted` boolean: This property will denote whether the request was aborted or not.
  - `session_id` string, required: The unique name for the session.
  - `account_sid` string, required: The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that sent the Message.
  - `body` string: If successful, the body of the generated response
  - `error` string: The error message if generation was not successful

## Other responses

- `202`: OK

## Changes

- **2025-05-13** (v1) `0852198458a0`: 1 info
  - removed the non-success response with the status `429`
- **2024-09-25** (v1) `1ad87f675d4b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/twilio/apis/assistants-v1/changes/v1/Assistants/:id/Messages/post.md)

---

[API](https://skmtc.dev/twilio/apis/assistants-v1.md) - [All operations](https://skmtc.dev/twilio/apis/assistants-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/twilio/apis/assistants-v1/revisions/c5ec7f024ee9?raw)