# Send a message to the assistant

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

send a message


## Servers
- https://assistants.twilio.com: https://assistants.twilio.com ()


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **id** (string)
  the Assistant ID.


### Body: application/json (object)

- **identity** (string)
  The unique identity of user for the session.
- **session_id** (string)
  The unique name for the session.
- **body** (string)
  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'


## Responses
### 200
OK

#### Body: application/json (object)
- **status** (string)
  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)
  The unique name for the session.
- **account_sid** (string)
  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

### 202
OK

#### Body: application/json (object)
- **status** (string)
  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)
  The unique name for the session.
- **account_sid** (string)
  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


[Powered by Bump.sh](https://bump.sh)