Update task

POST /v1/Assistants/{AssistantSid}/Tasks/{Sid}

TODO: Resource-level docs

Path parameters

  • AssistantSid string Required

    The SID of the Assistant that is the parent of the resource to update.

  • Sid string Required

    The Twilio-provided string that uniquely identifies the Task resource to update.

Body

  • Actions

    The JSON string that specifies the actions that instruct the Assistant on how to perform the task.

  • ActionsUrl string(uri)

    The URL from which the Assistant can fetch actions.

  • FriendlyName string

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

  • UniqueName string

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

Responses

  • 200

    OK

    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/{Sid} 
curl \
 -X POST https://autopilot.twilio.com/v1/Assistants/{AssistantSid}/Tasks/{Sid} \
 --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"
}
Request examples 
{
  "ActionsUrl": "https://example.com",
  "FriendlyName": "string",
  "UniqueName": "string"
}
Response examples (200) 
{
  "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"
}
Response examples (200) 
{
  "account_sid": "string",
  "actions_url": "https://example.com",
  "assistant_sid": "string",
  "date_created": "2025-05-04T09:42:00Z",
  "date_updated": "2025-05-04T09:42:00Z",
  "friendly_name": "string",
  "links": {},
  "sid": "string",
  "unique_name": "string",
  "url": "https://example.com"
}