naftiko: 1.0.0-alpha2
info:
label: Twilio - Autopilot — Assistants
description: 'Twilio - Autopilot — Assistants. 52 operations. Lead operation: Assistants. Self-contained Naftiko capability
covering one Twilio business surface.'
tags:
- Twilio
- Assistants
created: '2026-05-19'
modified: '2026-05-19'
binds:
- namespace: env
keys:
TWILIO_API_KEY: TWILIO_API_KEY
capability:
consumes:
- type: http
namespace: autopilot-assistants
baseUri: https://autopilot.twilio.com
description: Twilio - Autopilot — Assistants business capability. Self-contained, no shared references.
resources:
- name: v1-Assistants
path: /v1/Assistants
operations:
- name: listassistant
method: GET
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: PageSize
in: query
type: integer
description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
- name: Page
in: query
type: integer
description: The page index. This value is simply for client state.
- name: PageToken
in: query
type: string
description: The page token. This is provided by the API.
- name: createassistant
method: POST
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: v1-Assistants-Restore
path: /v1/Assistants/Restore
operations:
- name: updaterestoreassistant
method: POST
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: v1-Assistants-AssistantSid-Defaults
path: /v1/Assistants/{AssistantSid}/Defaults
operations:
- name: fetchdefaults
method: GET
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the resource to fetch.
required: true
- name: updatedefaults
method: POST
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the resource to update.
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: v1-Assistants-AssistantSid-Dialogues-Sid
path: /v1/Assistants/{AssistantSid}/Dialogues/{Sid}
operations:
- name: fetchdialogue
method: GET
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the resource to fetch.
required: true
- name: Sid
in: path
type: string
description: The Twilio-provided string that uniquely identifies the Dialogue resource to fetch.
required: true
- name: v1-Assistants-AssistantSid-FieldTypes
path: /v1/Assistants/{AssistantSid}/FieldTypes
operations:
- name: listfieldtype
method: GET
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the resources to read.
required: true
- name: PageSize
in: query
type: integer
description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
- name: Page
in: query
type: integer
description: The page index. This value is simply for client state.
- name: PageToken
in: query
type: string
description: The page token. This is provided by the API.
- name: createfieldtype
method: POST
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the new resource.
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: v1-Assistants-AssistantSid-FieldTypes-FieldTypeSid-FieldValues
path: /v1/Assistants/{AssistantSid}/FieldTypes/{FieldTypeSid}/FieldValues
operations:
- name: listfieldvalue
method: GET
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the FieldType associated with the resources to read.
required: true
- name: FieldTypeSid
in: path
type: string
description: The SID of the Field Type associated with the Field Value to read.
required: true
- name: Language
in: query
type: string
description: The [ISO language-country](https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html) tag
that specifies the language of the value. Currently support
- name: PageSize
in: query
type: integer
description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
- name: Page
in: query
type: integer
description: The page index. This value is simply for client state.
- name: PageToken
in: query
type: string
description: The page token. This is provided by the API.
- name: createfieldvalue
method: POST
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the FieldType associated with the new resource.
required: true
- name: FieldTypeSid
in: path
type: string
description: The SID of the Field Type associated with the Field Value.
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: v1-Assistants-AssistantSid-FieldTypes-FieldTypeSid-FieldValues-Sid
path: /v1/Assistants/{AssistantSid}/FieldTypes/{FieldTypeSid}/FieldValues/{Sid}
operations:
- name: fetchfieldvalue
method: GET
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the FieldType associated with the resource to fetch.
required: true
- name: FieldTypeSid
in: path
type: string
description: The SID of the Field Type associated with the Field Value to fetch.
required: true
- name: Sid
in: path
type: string
description: The Twilio-provided string that uniquely identifies the FieldValue resource to fetch.
required: true
- name: deletefieldvalue
method: DELETE
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the FieldType associated with the resources to delete.
required: true
- name: FieldTypeSid
in: path
type: string
description: The SID of the Field Type associated with the Field Value to delete.
required: true
- name: Sid
in: path
type: string
description: The Twilio-provided string that uniquely identifies the FieldValue resource to delete.
required: true
- name: v1-Assistants-AssistantSid-FieldTypes-Sid
path: /v1/Assistants/{AssistantSid}/FieldTypes/{Sid}
operations:
- name: fetchfieldtype
method: GET
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the resource to fetch.
required: true
- name: Sid
in: path
type: string
description: The Twilio-provided string that uniquely identifies the FieldType resource to fetch.
required: true
- name: updatefieldtype
method: POST
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the to update.
required: true
- name: Sid
in: path
type: string
description: The Twilio-provided string that uniquely identifies the FieldType resource to update.
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: deletefieldtype
method: DELETE
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the resources to delete.
required: true
- name: Sid
in: path
type: string
description: The Twilio-provided string that uniquely identifies the FieldType resource to delete.
required: true
- name: v1-Assistants-AssistantSid-ModelBuilds
path: /v1/Assistants/{AssistantSid}/ModelBuilds
operations:
- name: listmodelbuild
method: GET
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the resources to read.
required: true
- name: PageSize
in: query
type: integer
description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
- name: Page
in: query
type: integer
description: The page index. This value is simply for client state.
- name: PageToken
in: query
type: string
description: The page token. This is provided by the API.
- name: createmodelbuild
method: POST
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the new resource.
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: v1-Assistants-AssistantSid-ModelBuilds-Sid
path: /v1/Assistants/{AssistantSid}/ModelBuilds/{Sid}
operations:
- name: fetchmodelbuild
method: GET
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the resource to fetch.
required: true
- name: Sid
in: path
type: string
description: The Twilio-provided string that uniquely identifies the ModelBuild resource to fetch.
required: true
- name: updatemodelbuild
method: POST
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the resource to update.
required: true
- name: Sid
in: path
type: string
description: The Twilio-provided string that uniquely identifies the ModelBuild resource to update.
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: deletemodelbuild
method: DELETE
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the resources to delete.
required: true
- name: Sid
in: path
type: string
description: The Twilio-provided string that uniquely identifies the ModelBuild resource to delete.
required: true
- name: v1-Assistants-AssistantSid-Queries
path: /v1/Assistants/{AssistantSid}/Queries
operations:
- name: listquery
method: GET
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the resources to read.
required: true
- name: Language
in: query
type: string
description: 'The [ISO language-country](https://docs.oracle.com/cd/E13214_01/wli/docs92/xref/xqisocodes.html) string
that specifies the language used by the Query resources '
- name: ModelBuild
in: query
type: string
description: The SID or unique name of the [Model Build](https://www.twilio.com/docs/autopilot/api/model-build)
to be queried.
- name: Status
in: query
type: string
description: 'The status of the resources to read. Can be: `pending-review`, `reviewed`, or `discarded`'
- name: DialogueSid
in: query
type: string
description: The SID of the [Dialogue](https://www.twilio.com/docs/autopilot/api/dialogue).
- name: PageSize
in: query
type: integer
description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
- name: Page
in: query
type: integer
description: The page index. This value is simply for client state.
- name: PageToken
in: query
type: string
description: The page token. This is provided by the API.
- name: createquery
method: POST
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the new resource.
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: v1-Assistants-AssistantSid-Queries-Sid
path: /v1/Assistants/{AssistantSid}/Queries/{Sid}
operations:
- name: fetchquery
method: GET
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the resource to fetch.
required: true
- name: Sid
in: path
type: string
description: The Twilio-provided string that uniquely identifies the Query resource to fetch.
required: true
- name: updatequery
method: POST
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the resource to update.
required: true
- name: Sid
in: path
type: string
description: The Twilio-provided string that uniquely identifies the Query resource to update.
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: deletequery
method: DELETE
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the resources to delete.
required: true
- name: Sid
in: path
type: string
description: The Twilio-provided string that uniquely identifies the Query resource to delete.
required: true
- name: v1-Assistants-AssistantSid-StyleSheet
path: /v1/Assistants/{AssistantSid}/StyleSheet
operations:
- name: fetchstylesheet
method: GET
description: Returns Style sheet JSON object for the Assistant
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the resource to fetch.
required: true
- name: updatestylesheet
method: POST
description: Updates the style sheet for an Assistant identified by `assistant_sid`.
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the resource to update.
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: v1-Assistants-AssistantSid-Tasks
path: /v1/Assistants/{AssistantSid}/Tasks
operations:
- name: listtask
method: GET
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the resources to read.
required: true
- name: PageSize
in: query
type: integer
description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
- name: Page
in: query
type: integer
description: The page index. This value is simply for client state.
- name: PageToken
in: query
type: string
description: The page token. This is provided by the API.
- name: createtask
method: POST
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the new resource.
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: v1-Assistants-AssistantSid-Tasks-Sid
path: /v1/Assistants/{AssistantSid}/Tasks/{Sid}
operations:
- name: fetchtask
method: GET
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the resource to fetch.
required: true
- name: Sid
in: path
type: string
description: The Twilio-provided string that uniquely identifies the Task resource to fetch.
required: true
- name: updatetask
method: POST
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the resource to update.
required: true
- name: Sid
in: path
type: string
description: The Twilio-provided string that uniquely identifies the Task resource to update.
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: deletetask
method: DELETE
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the resources to delete.
required: true
- name: Sid
in: path
type: string
description: The Twilio-provided string that uniquely identifies the Task resource to delete.
required: true
- name: v1-Assistants-AssistantSid-Tasks-TaskSid-Actions
path: /v1/Assistants/{AssistantSid}/Tasks/{TaskSid}/Actions
operations:
- name: fetchtaskactions
method: GET
description: Returns JSON actions for the Task.
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the Task for which the task actions to fetch were defined.
required: true
- name: TaskSid
in: path
type: string
description: The SID of the [Task](https://www.twilio.com/docs/autopilot/api/task) for which the task actions to
fetch were defined.
required: true
- name: updatetaskactions
method: POST
description: Updates the actions of an Task identified by {TaskSid} or {TaskUniqueName}.
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the Task for which the task actions to update were defined
required: true
- name: TaskSid
in: path
type: string
description: The SID of the [Task](https://www.twilio.com/docs/autopilot/api/task) for which the task actions to
update were defined.
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: v1-Assistants-AssistantSid-Tasks-TaskSid-Fields
path: /v1/Assistants/{AssistantSid}/Tasks/{TaskSid}/Fields
operations:
- name: listfield
method: GET
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the Task associated with the resources to read.
required: true
- name: TaskSid
in: path
type: string
description: The SID of the [Task](https://www.twilio.com/docs/autopilot/api/task) resource associated with the
Field resources to read.
required: true
- name: PageSize
in: query
type: integer
description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
- name: Page
in: query
type: integer
description: The page index. This value is simply for client state.
- name: PageToken
in: query
type: string
description: The page token. This is provided by the API.
- name: createfield
method: POST
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the Task associated with the new resource.
required: true
- name: TaskSid
in: path
type: string
description: The SID of the [Task](https://www.twilio.com/docs/autopilot/api/task) resource associated with the
new Field resource.
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: false
- name: v1-Assistants-AssistantSid-Tasks-TaskSid-Fields-Sid
path: /v1/Assistants/{AssistantSid}/Tasks/{TaskSid}/Fields/{Sid}
operations:
- name: fetchfield
method: GET
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the Task associated with the resource to fetch.
required: true
- name: TaskSid
in: path
type: string
description: The SID of the [Task](https://www.twilio.com/docs/autopilot/api/task) resource associated with the
Field resource to fetch.
required: true
- name: Sid
in: path
type: string
description: The Twilio-provided string that uniquely identifies the Field resource to fetch.
required: true
- name: deletefield
method: DELETE
description: ''
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: AssistantSid
in: path
type: string
description: The SID of the [Assistant](https://www.twilio.com/docs/autopilot/api/assistant) that is the parent
of the Task associated with the resources to delete.
required: true
- name: TaskSid
in: path
type: string
description: The SID of the [Task](https://www.twilio.com/docs/autopilot/api/task) resource associated with the
Field resource to delete.
required: true
- name: Sid
in: path
type: string
description: The Twilio-provided string that uniquely identifies the Field resource to delete.
required: true
- name: v1-Assistants-AssistantSid-Tasks-TaskSid-Samples
path: /v1/Assistants/{AssistantSid}/Tasks/{TaskSid}/Samples
operations:
# --- truncated at 32 KB (83 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/twilio/refs/heads/main/capabilities/autopilot-assistants.yaml