# Create query

**POST /v1/Assistants/{AssistantSid}/Queries**


TODO: Resource-level docs

## Servers



## Parameters

### Path parameters
- **AssistantSid** (string)
  The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent of the new resource.


### Body:  (object)

- **Language** (string)
  The [ISO language-country](https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html) string that specifies the language used for the new query. For example: `en-US`.
- **ModelBuild** (string)
  The SID or unique name of the [Model Build](https://www.twilio.com/docs/autopilot/api/model-build) to be queried.
- **Query** (string)
  The end-user's natural language input. It can be up to 2048 characters long.
- **Tasks** (string)
  The list of tasks to limit the new query to. Tasks are expressed as a comma-separated list of task `unique_name` values. For example, `task-unique_name-1, task-unique_name-2`. Listing specific tasks is useful to constrain the paths that a user can take.


## Responses
### 201
Created

#### Body:  (object)
- **account_sid** (string | null)
  The SID of the Account that created the resource
- **assistant_sid** (string | null)
  The SID of the Assistant that is the parent of the resource
- **date_created** (string(date-time) | null)
  The RFC 2822 date and time in GMT when the resource was created
- **date_updated** (string(date-time) | null)
  The RFC 2822 date and time in GMT when the resource was last updated
- **dialogue_sid** (string | null)
  The SID of the [Dialogue](https://www.twilio.com/docs/autopilot/api/dialogue).
- **language** (string | null)
  The ISO language-country string that specifies the language used by the Query
- **model_build_sid** (string | null)
  The SID of the [Model Build](https://www.twilio.com/docs/autopilot/api/model-build) queried
- **query** (string | null)
  The end-user's natural language input
- **results** ()
  The natural language analysis results that include the Task recognized and a list of identified Fields
- **sample_sid** (string | null)
  The SID of an optional reference to the Sample created from the query
- **sid** (string | null)
  The unique string that identifies the resource
- **source_channel** (string | null)
  The communication channel from where the end-user input came
- **status** (string | null)
  The status of the Query
- **url** (string(uri) | null)
  The absolute URL of the Query resource


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