Create task

POST /v1/Assistants/{AssistantSid}/Tasks

TODO: Resource-level docs

Path parameters

AssistantSid string Required

The SID of the Assistant that is the parent of the new resource.

application/x-www-form-urlencoded

Body

Actions

The JSON string that specifies the actions that instruct the Assistant on how to perform the task. It is optional and not unique.
ActionsUrl string(uri)

The URL from which the Assistant can fetch actions.
FriendlyName string

A descriptive string that you create to describe the new resource. It is not unique and can be up to 255 characters long.
UniqueName string Required

An application-defined string that uniquely identifies the new resource. It can be used as an alternative to the sid in the URL path to address the resource. This value must be unique and 64 characters or less in length.

Responses

• 201

Created
Hide response attributes Show response attributes object
- account_sid string | null
  
  The SID of the Account that created the resource
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.
- actions_url string(uri) | null
  
  The URL from which the Assistant can fetch actions
- assistant_sid string | null
  
  The SID of the Assistant that is the parent of the resource
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^UA[0-9a-fA-F]{32}$.
- 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
- friendly_name string | null
  
  The string that you assigned to describe the resource
- links object(uri-map) | null
  
  A list of the URLs of related resources
- sid string | null
  
  The unique string that identifies the resource
  
  Minimum length is 34, maximum length is 34. Format should match the following pattern: ^UD[0-9a-fA-F]{32}$.
- unique_name string | null
  
  An application-defined string that uniquely identifies the resource
- url string(uri) | null
  
  The absolute URL of the Task resource

POST /v1/Assistants/{AssistantSid}/Tasks

curl \
 -X POST https://autopilot.twilio.com/v1/Assistants/{AssistantSid}/Tasks \
 --user "username:password" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d 'ActionsUrl=https%3A%2F%2Fexample.com&FriendlyName=string&UniqueName=string'

Request example

{
  "ActionsUrl": "https://example.com",
  "FriendlyName": "string",
  "UniqueName": "string"
}

Response examples (201)

{
  "account_sid": "string",
  "actions_url": "https://example.com",
  "assistant_sid": "string",
  "date_created": "2023-05-04T09:42:00+00:00",
  "date_updated": "2023-05-04T09:42:00+00:00",
  "friendly_name": "string",
  "links": {},
  "sid": "string",
  "unique_name": "string",
  "url": "https://example.com"
}