---
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`

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

---

[API](https://skmtc.net/twilio/apis/assistants-v1.md) · [All operations](https://skmtc.net/twilio/apis/assistants-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/assistants-v1/revisions/c5ec7f024ee9/schema)