naftiko: 1.0.0-alpha2 info: label: Twilio Assistants — Understand description: 'Twilio Assistants — Understand. 46 operations. Lead operation: Understand. Self-contained Naftiko capability covering one Twilio business surface.' tags: - Twilio - Understand created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: TWILIO_API_KEY: TWILIO_API_KEY capability: consumes: - type: http namespace: assistant-understand baseUri: https://preview.twilio.com description: Twilio Assistants — Understand business capability. Self-contained, no shared references. resources: - name: understand-Assistants-AssistantSid-Dialogues-Sid path: /understand/Assistants/{AssistantSid}/Dialogues/{Sid} operations: - name: fetchunderstanddialogue method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string required: true - name: Sid in: path type: string required: true - name: understand-Assistants-AssistantSid-FallbackActions path: /understand/Assistants/{AssistantSid}/FallbackActions operations: - name: fetchunderstandassistantfallbackactions method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string required: true - name: updateunderstandassistantfallbackactions method: POST description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: understand-Assistants-AssistantSid-FieldTypes path: /understand/Assistants/{AssistantSid}/FieldTypes operations: - name: listunderstandfieldtype method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string 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: createunderstandfieldtype method: POST description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: understand-Assistants-AssistantSid-FieldTypes-FieldTypeSid-FieldValues path: /understand/Assistants/{AssistantSid}/FieldTypes/{FieldTypeSid}/FieldValues operations: - name: listunderstandfieldvalue method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string required: true - name: FieldTypeSid in: path type: string required: true - name: Language in: query type: string description: 'An ISO language-country string of the value. For example: *en-US*' - 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: createunderstandfieldvalue method: POST description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string required: true - name: FieldTypeSid in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: understand-Assistants-AssistantSid-FieldTypes-FieldTypeSid-FieldValues-Sid path: /understand/Assistants/{AssistantSid}/FieldTypes/{FieldTypeSid}/FieldValues/{Sid} operations: - name: fetchunderstandfieldvalue method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string required: true - name: FieldTypeSid in: path type: string required: true - name: Sid in: path type: string required: true - name: deleteunderstandfieldvalue method: DELETE description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string required: true - name: FieldTypeSid in: path type: string required: true - name: Sid in: path type: string required: true - name: understand-Assistants-AssistantSid-FieldTypes-Sid path: /understand/Assistants/{AssistantSid}/FieldTypes/{Sid} operations: - name: fetchunderstandfieldtype method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string required: true - name: Sid in: path type: string required: true - name: updateunderstandfieldtype method: POST description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string required: true - name: Sid in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: deleteunderstandfieldtype method: DELETE description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string required: true - name: Sid in: path type: string required: true - name: understand-Assistants-AssistantSid-InitiationActions path: /understand/Assistants/{AssistantSid}/InitiationActions operations: - name: fetchunderstandassistantinitiationactions method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string required: true - name: updateunderstandassistantinitiationactions method: POST description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: understand-Assistants-AssistantSid-ModelBuilds path: /understand/Assistants/{AssistantSid}/ModelBuilds operations: - name: listunderstandmodelbuild method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string 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: createunderstandmodelbuild method: POST description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: understand-Assistants-AssistantSid-ModelBuilds-Sid path: /understand/Assistants/{AssistantSid}/ModelBuilds/{Sid} operations: - name: fetchunderstandmodelbuild method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string required: true - name: Sid in: path type: string required: true - name: updateunderstandmodelbuild method: POST description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string required: true - name: Sid in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: deleteunderstandmodelbuild method: DELETE description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string required: true - name: Sid in: path type: string required: true - name: understand-Assistants-AssistantSid-Queries path: /understand/Assistants/{AssistantSid}/Queries operations: - name: listunderstandquery method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the parent Assistant. required: true - name: Language in: query type: string description: An ISO language-country string of the sample. - name: ModelBuild in: query type: string description: The Model Build Sid or unique name of the Model Build to be queried. - name: Status in: query type: string description: 'A string that described the query status. The values can be: pending_review, reviewed, discarded' - 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: createunderstandquery method: POST description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the parent Assistant. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: understand-Assistants-AssistantSid-Queries-Sid path: /understand/Assistants/{AssistantSid}/Queries/{Sid} operations: - name: fetchunderstandquery method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the Assistant. required: true - name: Sid in: path type: string description: A 34 character string that uniquely identifies this resource. required: true - name: updateunderstandquery method: POST description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the parent Assistant. required: true - name: Sid in: path type: string description: A 34 character string that uniquely identifies this resource. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: deleteunderstandquery method: DELETE description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the Assistant. required: true - name: Sid in: path type: string description: A 34 character string that uniquely identifies this resource. required: true - name: understand-Assistants-AssistantSid-StyleSheet path: /understand/Assistants/{AssistantSid}/StyleSheet operations: - name: fetchunderstandstylesheet method: GET description: Returns Style sheet JSON object for this Assistant outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the Assistant required: true - name: updateunderstandstylesheet method: POST description: Updates the style sheet for an assistant identified by {AssistantSid} or {AssistantUniqueName}. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the Assistant required: true - name: body in: body type: object description: Request body (JSON). required: false - name: understand-Assistants-AssistantSid-Tasks path: /understand/Assistants/{AssistantSid}/Tasks operations: - name: listunderstandtask method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the Assistant. 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: createunderstandtask method: POST description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the Assistant. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: understand-Assistants-AssistantSid-Tasks-Sid path: /understand/Assistants/{AssistantSid}/Tasks/{Sid} operations: - name: fetchunderstandtask method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the Assistant. required: true - name: Sid in: path type: string description: A 34 character string that uniquely identifies this resource. required: true - name: updateunderstandtask method: POST description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the Assistant. required: true - name: Sid in: path type: string description: A 34 character string that uniquely identifies this resource. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: deleteunderstandtask method: DELETE description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the Assistant. required: true - name: Sid in: path type: string description: A 34 character string that uniquely identifies this resource. required: true - name: understand-Assistants-AssistantSid-Tasks-TaskSid-Actions path: /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Actions operations: - name: fetchunderstandtaskactions method: GET description: Returns JSON actions for this Task. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the parent Assistant. required: true - name: TaskSid in: path type: string description: The unique ID of the Task. required: true - name: updateunderstandtaskactions 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 unique ID of the parent Assistant. required: true - name: TaskSid in: path type: string description: The unique ID of the Task. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: understand-Assistants-AssistantSid-Tasks-TaskSid-Fields path: /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Fields operations: - name: listunderstandfield method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the Assistant. required: true - name: TaskSid in: path type: string description: The unique ID of the Task associated with this Field. 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: createunderstandfield method: POST description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the parent Assistant. required: true - name: TaskSid in: path type: string description: The unique ID of the Task associated with this Field. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: understand-Assistants-AssistantSid-Tasks-TaskSid-Fields-Sid path: /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Fields/{Sid} operations: - name: fetchunderstandfield method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the Assistant. required: true - name: TaskSid in: path type: string description: The unique ID of the Task associated with this Field. required: true - name: Sid in: path type: string description: A 34 character string that uniquely identifies this resource. required: true - name: deleteunderstandfield method: DELETE description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the Assistant. required: true - name: TaskSid in: path type: string description: The unique ID of the Task associated with this Field. required: true - name: Sid in: path type: string description: A 34 character string that uniquely identifies this resource. required: true - name: understand-Assistants-AssistantSid-Tasks-TaskSid-Samples path: /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Samples operations: - name: listunderstandsample method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the Assistant. required: true - name: TaskSid in: path type: string description: The unique ID of the Task associated with this Sample. required: true - name: Language in: query type: string description: An ISO language-country string of the sample. - 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: createunderstandsample method: POST description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the Assistant. required: true - name: TaskSid in: path type: string description: The unique ID of the Task associated with this Sample. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: understand-Assistants-AssistantSid-Tasks-TaskSid-Samples-Sid path: /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Samples/{Sid} operations: - name: fetchunderstandsample method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the Assistant. required: true - name: TaskSid in: path type: string description: The unique ID of the Task associated with this Sample. required: true - name: Sid in: path type: string description: A 34 character string that uniquely identifies this resource. required: true - name: updateunderstandsample method: POST description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the Assistant. required: true - name: TaskSid in: path type: string description: The unique ID of the Task associated with this Sample. required: true - name: Sid in: path type: string description: A 34 character string that uniquely identifies this resource. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: deleteunderstandsample method: DELETE description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the Assistant. required: true - name: TaskSid in: path type: string description: The unique ID of the Task associated with this Sample. required: true - name: Sid in: path type: string description: A 34 character string that uniquely identifies this resource. required: true - name: understand-Assistants-AssistantSid-Tasks-TaskSid-Statistics path: /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Statistics operations: - name: fetchunderstandtaskstatistics method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: AssistantSid in: path type: string description: The unique ID of the parent Assistant. required: true - name: TaskSid in: path type: string description: The unique ID of the Task associated with this Field. required: true - name: understand-Assistants-Sid path: /understand/Assistants/{Sid} operations: - name: fetchunderstandassistant method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Sid in: path type: string description: A 34 character string that uniquely identifies this resource. required: true - name: updateunderstandassistant method: POST description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Sid in: path type: string description: A 34 character string that uniquely identifies this resource. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: deleteunderstandassistant method: DELETE description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Sid in: path type: string description: A 34 character string that uniquely identifies this resource. required: true authentication: type: basic username: '{{env.TWILIO_USER}}' password: '{{env.TWILIO_PASS}}' exposes: - type: rest namespace: assistant-understand-rest port: 8080 description: REST adapter for Twilio Assistants — Understand. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/understand/assistants/{assistantsid}/dialogues/{sid} name: understand-assistants-assistantsid-dialogues-sid description: REST surface for understand-Assistants-AssistantSid-Dialogues-Sid. operations: - method: GET name: fetchunderstanddialogue description: fetchunderstanddialogue call: assistant-understand.fetchunderstanddialogue with: AssistantSid: rest.AssistantSid Sid: rest.Sid outputParameters: - type: object mapping: $. - path: /v1/understand/assistants/{assistantsid}/fallbackactions name: understand-assistants-assistantsid-fallbackactions description: REST surface for understand-Assistants-AssistantSid-FallbackActions. operations: - method: GET name: fetchunderstandassistantfallbackactions description: fetchunderstandassistantfallbackactions call: assistant-understand.fetchunderstandassistantfallbackactions with: AssistantSid: rest.AssistantSid outputParameters: - type: object mapping: $. - method: POST name: updateunderstandassistantfallbackactions description: updateunderstandassistantfallbackactions call: assistant-understand.updateunderstandassistantfallbackactions with: AssistantSid: rest.AssistantSid body: rest.body outputParameters: - type: object mapping: $. - path: /v1/understand/assistants/{assistantsid}/fieldtypes name: understand-assistants-assistantsid-fieldtypes description: REST surface for understand-Assistants-AssistantSid-FieldTypes. operations: - method: GET name: listunderstandfieldtype description: listunderstandfieldtype call: assistant-understand.listunderstandfieldtype with: AssistantSid: rest.AssistantSid PageSize: rest.PageSize Page: rest.Page PageToken: rest.PageToken outputParameters: - type: object mapping: $. - method: POST name: createunderstandfieldtype description: createunderstandfieldtype call: assistant-understand.createunderstandfieldtype with: AssistantSid: rest.AssistantSid body: rest.body outputParameters: - type: object mapping: $. - path: /v1/understand/assistants/{assistantsid}/fieldtypes/{fieldtypesid}/fieldvalues name: understand-assistants-assistantsid-fieldtypes-fieldtypesid-fieldvalues description: REST surface for understand-Assistants-AssistantSid-FieldTypes-FieldTypeSid-FieldValues. operations: - method: GET name: listunderstandfieldvalue description: listunderstandfieldvalue call: assistant-understand.listunderstandfieldvalue with: AssistantSid: rest.AssistantSid FieldTypeSid: rest.FieldTypeSid Language: rest.Language PageSize: rest.PageSize Page: rest.Page PageToken: rest.PageToken outputParameters: - type: object mapping: $. - method: POST name: createunderstandfieldvalue description: createunderstandfieldvalue call: assistant-understand.createunderstandfieldvalue with: AssistantSid: rest.AssistantSid FieldTypeSid: rest.FieldTypeSid body: rest.body outputParameters: - type: object mapping: $. - path: /v1/understand/assistants/{assistantsid}/fieldtypes/{fieldtypesid}/fieldvalues/{sid} name: understand-assistants-assistantsid-fieldtypes-fieldtypesid-fieldvalues-sid description: REST surface for understand-Assistants-AssistantSid-FieldTypes-FieldTypeSid-FieldValues-Sid. operations: - method: GET name: fetchunderstandfieldvalue description: fetchunderstandfieldvalue call: assistant-understand.fetchunderstandfieldvalue with: AssistantSid: rest.AssistantSid FieldTypeSid: rest.FieldTypeSid Sid: rest.Sid outputParameters: - type: object mapping: $. - method: DELETE name: deleteunderstandfieldvalue description: deleteunderstandfieldvalue call: assistant-understand.deleteunderstandfieldvalue with: AssistantSid: rest.AssistantSid FieldTypeSid: rest.FieldTypeSid Sid: rest.Sid outputParameters: - type: object mapping: $. - path: /v1/understand/assistants/{assistantsid}/fieldtypes/{sid} name: understand-assistants-assistantsid-fieldtypes-sid description: REST surface for understand-Assistants-AssistantSid-FieldTypes-Sid. operations: - method: GET name: fetchunderstandfieldtype description: fetchunderstandfieldtype call: assistant-understand.fetchunderstandfieldtype with: AssistantSid: rest.AssistantSid Sid: rest.Sid outputParameters: - type: object mapping: $. - method: POST name: updateunderstandfieldtype description: updateunderstandfieldtype call: assistant-understand.updateunderstandfieldtype with: AssistantSid: rest.AssistantSid Sid: rest.Sid body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: deleteunderstandfieldtype description: deleteunderstandfieldtype call: assistant-understand.deleteunderstandfieldtype with: AssistantSid: rest.AssistantSid Sid: rest.Sid outputParameters: - type: object mapping: $. - path: /v1/understand/assistants/{assistantsid}/initiationactions name: understand-assistants-assistantsid-initiationactions description: REST surface for understand-Assistants-AssistantSid-InitiationActions. operations: - method: GET name: fetchunderstandassistantinitiationactions description: fetchunderstandassistantinitiationactions call: assistant-understand.fetchunderstandassistantinitiationactions with: AssistantSid: rest.AssistantSid outputParameters: - type: object mapping: $. - method: POST name: updateunderstandassistantinitiationactions description: updateunderstandassistantinitiationactions call: assistant-understand.updateunderstandassistantinitiationactions with: AssistantSid: rest.AssistantSid body: rest.body outputParameters: - type: object mapping: $. - path: /v1/understand/assistants/{assistantsid}/modelbuilds name: understand-assistants-assistantsid-modelbuilds description: REST surface for understand-Assistants-AssistantSid-ModelBuilds. operations: - method: GET name: listunderstandmodelbuild description: listunderstandmodelbuild call: assistant-understand.listunderstandmodelbuild with: AssistantSid: rest.AssistantSid PageSize: rest.PageSize Page: rest.Page PageToken: rest.PageToken outputParameters: - type: object mapping: $. - method: POST name: createunderstandmodelbuild description: createunderstandmodelbuild call: assistant-understand.createunderstandmodelbuild with: AssistantSid: rest.AssistantSid body: rest.body outputParameters: - type: object mapping: $. - path: /v1/understand/assistants/{assistantsid}/modelbuilds/{sid} name: understand-assistants-assistantsid-modelbuilds-sid description: REST surface for understand-Assistants-AssistantSid-ModelBuilds-Sid. operations: - method: GET name: fetchunderstandmodelbuild description: fetchunderstandmodelbuild call: assistant-understand.fetchunderstandmodelbuild with: AssistantSid: rest.AssistantSid Sid: rest.Sid outputParameters: - type: object mapping: $. - method: POST name: updateunderstandmodelbuild description: updateunderstandmodelbuild call: assistant-understand.updateunderstandmodelbuild with: AssistantSid: rest.AssistantSid Sid: rest.Sid body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: deleteunderstandmodelbuild description: deleteunderstandmodelbuild call: assistant-understand.deleteunderstandmodelbuild with: AssistantSid: rest.AssistantSid Sid: rest.Sid outputParameters: - type: object mapping: $. - path: /v1/understand/assistants/{assistantsid}/queries name: understand-assistants-assistantsid-queries description: REST surface for understand-Assistants-AssistantSid-Queries. operations: - method: GET name: listunderstandquery description: listunderstandquery call: assistant-understand.listunderstandquery with: AssistantSid: rest.AssistantSid Language: rest.Language ModelBuild: rest.ModelBuild Status: rest.Status PageSize: rest.PageSize Page: rest.Page PageToken: rest.PageToken outputParameters: - type: object mapping: $. - method: POST name: createunderstandquery description: createunderstandquery call: assistant-understand.createunderstandquery with: AssistantSid: rest.AssistantSid body: rest.body outputParameters: - type: object mapping: $. - path: /v1/understand/assistants/{assistantsid}/queries/{sid} name: understand-assistants-assistantsid-queries-sid description: REST surface for understand-Assistants-AssistantSid-Queries-Sid. operations: - method: GET name: fetchunderstandquery description: fetchunderstandquery call: assistant-understand.fetchunderstandquery with: AssistantSid: rest.AssistantSid Sid: rest.Sid outputParameters: - type: object mapping: $. - method: POST name: updateunderstandquery description: updateunderstandquery call: assistant-understand.updateunderstandquery with: AssistantSid: rest.AssistantSid Sid: rest.Sid body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: deleteunderstandquery description: deleteunderstandquery call: assistant-understand.deleteunderstandquery with: AssistantSid: rest.AssistantSid Sid: rest.Sid outputParameters: - type: object mapping: $. - path: /v1/understand/assistants/{assistantsid}/stylesheet name: understand-assistants-assistantsid-stylesheet description: REST surface for understand-Assistants-AssistantSid-StyleSheet. operations: - method: GET name: fetchunderstandstylesheet description: Returns Style sheet JSON object for this Assistant call: assistant-understand.fetchunderstandstylesheet with: AssistantSid: rest.AssistantSid outputParameters: - type: object mapping: $. - method: POST name: updateunderstandstylesheet description: Updates the style sheet for an assistant identified by {AssistantSid} or {AssistantUniqueName}. call: assistant-understand.updateunderstandstylesheet with: AssistantSid: rest.AssistantSid body: rest.body outputParameters: - type: object mapping: $. - path: /v1/understand/assistants/{assistantsid}/tasks name: understand-assistants-assistantsid-tasks description: REST surface for understand-Assistants-AssistantSid-Tasks. operations: - method: GET name: listunderstandtask description: listunderstandtask call: assistant-understand.listunderstandtask with: AssistantSid: rest.AssistantSid PageSize: rest.PageSize Page: rest.Page PageToken: rest.PageToken outputParameters: - type: object mapping: $. - method: POST name: createunderstandtask description: createunderstandtask call: assistant-understand.createunderstandtask with: AssistantSid: rest.AssistantSid body: rest.body outputParameters: - type: object mapping: $. - path: /v1/understand/assistants/{assistantsid}/tasks/{sid} name: understand-assistants-assistantsid-tasks-sid description: REST surface for understand-Assistants-AssistantSid-Tasks-Sid. operations: - method: GET name: fetchunderstandtask description: fetchunderstandtask call: assistant-understand.fetchunderstandtask with: AssistantSid: rest.AssistantSid Sid: rest.Sid outputParameters: - type: object mapping: $. - method: POST name: updateunderstandtask description: updateunderstandtask call: assistant-understand.updateunderstandtask with: AssistantSid: rest.AssistantSid Sid: rest.Sid body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: deleteunderstandtask description: deleteunderstandtask call: assistant-understand.deleteunderstandtask with: AssistantSid: rest.AssistantSid Sid: rest.Sid outputParameters: - type: object mapping: $. - path: /v1/understand/assistants/{assistantsid}/tasks/{tasksid}/actions name: understand-assistants-assistantsid-tasks-tasksid-actions description: REST surface for understand-Assistants-AssistantSid-Tasks-TaskSid-Actions. operations: - method: GET name: fetchunderstandtaskactions description: Returns JSON actions for this Task. call: assistant-understand.fetchunderstandtaskactions with: AssistantSid: rest.AssistantSid TaskSid: rest.TaskSid outputParameters: - type: object mapping: $. - method: POST name: updateunderstandtaskactions description: Updates the actions of an Task identified by {TaskSid} or {TaskUniqueName}. call: assistant-understand.updateunderstandtaskactions with: AssistantSid: rest.AssistantSid TaskSid: rest.TaskSid body: rest.body outputParameters: - type: object mapping: $. - path: /v1/understand/assistants/{assistantsid}/tasks/{tasksid}/fields name: understand-assistants-assistantsid-tasks-tasksid-fields description: REST surface for understand-Assistants-AssistantSid-Tasks-TaskSid-Fields. operations: - method: GET name: listunderstandfield description: listunderstandfield call: assistant-understand.listunderstandfield with: AssistantSid: rest.AssistantSid TaskSid: rest.TaskSid PageSize: rest.PageSize Page: rest.Page PageToken: rest.PageToken outputParameters: - type: object mapping: $. - method: POST name: createunderstandfield description: createunderstandfield call: assistant-understand.createunderstandfield with: AssistantSid: rest.AssistantSid TaskSid: rest.TaskSid body: rest.body outputParameters: - type: object mapping: $. - path: /v1/understand/assistants/{assistantsid}/tasks/{tasksid}/fields/{sid} name: understand-assistants-assistantsid-tasks-tasksid-fields-sid description: REST surface for understand-Assistants-AssistantSid-Tasks-TaskSid-Fields-Sid. operations: - method: GET name: fetchunderstandfield description: fetchunderstandfield call: assistant-understand.fetchunderstandfield with: AssistantSid: rest.AssistantSid TaskSid: rest.TaskSid Sid: rest.Sid outputParameters: - type: object mapping: $. - method: DELETE name: deleteunderstandfield description: deleteunderstandfield call: assistant-understand.deleteunderstandfield with: AssistantSid: rest.AssistantSid TaskSid: rest.TaskSid Sid: rest.Sid outputParameters: - type: object mapping: $. - path: /v1/understand/assistants/{assistantsid}/tasks/{tasksid}/samples name: understand-assistants-assistantsid-tasks-tasksid-samples description: REST surface for understand-Assistants-AssistantSid-Tasks-TaskSid-Samples. operations: - method: GET name: listunderstandsample description: listunderstandsample call: assistant-understand.listunderstandsample with: AssistantSid: rest.AssistantSid TaskSid: rest.TaskSid Language: rest.Language PageSize: rest.PageSize Page: rest.Page PageToken: rest.PageToken outputParameters: - type: object mapping: $. - method: POST name: createunderstandsample description: createunderstandsample call: assistant-understand.createunderstandsample with: AssistantSid: rest.AssistantSid TaskSid: rest.TaskSid body: rest.body outputParameters: - type: object mapping: $. - path: /v1/understand/assistants/{assistantsid}/tasks/{tasksid}/samples/{sid} name: understand-assistants-assistantsid-tasks-tasksid-samples-sid description: REST surface for understand-Assistants-AssistantSid-Tasks-TaskSid-Samples-Sid. operations: - method: GET name: fetchunderstandsample description: fetchunderstandsample call: assistant-understand.fetchunderstandsample with: AssistantSid: rest.AssistantSid TaskSid: rest.TaskSid Sid: rest.Sid outputParameters: - type: object mapping: $. - method: POST name: updateunderstandsample description: updateunderstandsample call: assistant-understand.updateunderstandsample with: AssistantSid: rest.AssistantSid TaskSid: rest.TaskSid Sid: rest.Sid body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: deleteunderstandsample description: deleteunderstandsample call: assistant-understand.deleteunderstandsample with: AssistantSid: rest.AssistantSid TaskSid: rest.TaskSid Sid: rest.Sid outputParameters: - type: object mapping: $. - path: /v1/understand/assistants/{assistantsid}/tasks/{tasksid}/statistics name: understand-assistants-assistantsid-tasks-tasksid-statistics description: REST surface for understand-Assistants-AssistantSid-Tasks-TaskSid-Statistics. operations: - method: GET name: fetchunderstandtaskstatistics description: fetchunderstandtaskstatistics call: assistant-understand.fetchunderstandtaskstatistics with: AssistantSid: rest.AssistantSid TaskSid: rest.TaskSid outputParameters: - type: object mapping: $. - path: /v1/understand/assistants/{sid} name: understand-assistants-sid description: REST surface for understand-Assistants-Sid. operations: - method: GET name: fetchunderstandassistant description: fetchunderstandassistant call: assistant-understand.fetchunderstandassistant with: Sid: rest.Sid outputParameters: - type: object mapping: $. - method: POST name: updateunderstandassistant description: updateunderstandassistant call: assistant-understand.updateunderstandassistant with: Sid: rest.Sid body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: deleteunderstandassistant description: deleteunderstandassistant call: assistant-understand.deleteunderstandassistant with: Sid: rest.Sid outputParameters: - type: object mapping: $. - type: mcp namespace: assistant-understand-mcp port: 9090 transport: http description: MCP adapter for Twilio Assistants — Understand. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: fetchunderstanddialogue description: fetchunderstanddialogue hints: readOnly: true destructive: false idempotent: true call: assistant-understand.fetchunderstanddialogue with: AssistantSid: tools.AssistantSid Sid: tools.Sid outputParameters: - type: object mapping: $. - name: fetchunderstandassistantfallbackactions description: fetchunderstandassistantfallbackactions hints: readOnly: true destructive: false idempotent: true call: assistant-understand.fetchunderstandassistantfallbackactions with: AssistantSid: tools.AssistantSid outputParameters: - type: object mapping: $. - name: updateunderstandassistantfallbackactions description: updateunderstandassistantfallbackactions hints: readOnly: false destructive: false idempotent: false call: assistant-understand.updateunderstandassistantfallbackactions with: AssistantSid: tools.AssistantSid body: tools.body outputParameters: - type: object mapping: $. - name: listunderstandfieldtype description: listunderstandfieldtype hints: readOnly: true destructive: false idempotent: true call: assistant-understand.listunderstandfieldtype with: AssistantSid: tools.AssistantSid PageSize: tools.PageSize Page: tools.Page PageToken: tools.PageToken outputParameters: - type: object mapping: $. - name: createunderstandfieldtype description: createunderstandfieldtype hints: readOnly: false destructive: false idempotent: false call: assistant-understand.createunderstandfieldtype with: AssistantSid: tools.AssistantSid body: tools.body outputParameters: - type: object mapping: $. - name: listunderstandfieldvalue description: listunderstandfieldvalue hints: readOnly: true destructive: false idempotent: true call: assistant-understand.listunderstandfieldvalue with: AssistantSid: tools.AssistantSid FieldTypeSid: tools.FieldTypeSid Language: tools.Language PageSize: tools.PageSize Page: tools.Page PageToken: tools.PageToken outputParameters: - type: object mapping: $. - name: createunderstandfieldvalue description: createunderstandfieldvalue hints: readOnly: false destructive: false idempotent: false call: assistant-understand.createunderstandfieldvalue with: AssistantSid: tools.AssistantSid FieldTypeSid: tools.FieldTypeSid body: tools.body outputParameters: - type: object mapping: $. - name: fetchunderstandfieldvalue description: fetchunderstandfieldvalue hints: readOnly: true destructive: false idempotent: true call: assistant-understand.fetchunderstandfieldvalue with: AssistantSid: tools.AssistantSid FieldTypeSid: tools.FieldTypeSid Sid: tools.Sid outputParameters: - type: object mapping: $. - name: deleteunderstandfieldvalue description: deleteunderstandfieldvalue hints: readOnly: false destructive: true idempotent: true call: assistant-understand.deleteunderstandfieldvalue with: AssistantSid: tools.AssistantSid FieldTypeSid: tools.FieldTypeSid Sid: tools.Sid outputParameters: - type: object mapping: $. - name: fetchunderstandfieldtype description: fetchunderstandfieldtype hints: readOnly: true destructive: false idempotent: true call: assistant-understand.fetchunderstandfieldtype with: AssistantSid: tools.AssistantSid Sid: tools.Sid outputParameters: - type: object mapping: $. - name: updateunderstandfieldtype description: updateunderstandfieldtype hints: readOnly: false destructive: false idempotent: false call: assistant-understand.updateunderstandfieldtype with: AssistantSid: tools.AssistantSid Sid: tools.Sid body: tools.body outputParameters: - type: object mapping: $. - name: deleteunderstandfieldtype description: deleteunderstandfieldtype hints: readOnly: false destructive: true idempotent: true call: assistant-understand.deleteunderstandfieldtype with: AssistantSid: tools.AssistantSid Sid: tools.Sid outputParameters: - type: object mapping: $. - name: fetchunderstandassistantinitiationactions description: fetchunderstandassistantinitiationactions hints: readOnly: true destructive: false idempotent: true call: assistant-understand.fetchunderstandassistantinitiationactions with: AssistantSid: tools.AssistantSid outputParameters: - type: object mapping: $. - name: updateunderstandassistantinitiationactions description: updateunderstandassistantinitiationactions hints: readOnly: false destructive: false idempotent: false call: assistant-understand.updateunderstandassistantinitiationactions with: AssistantSid: tools.AssistantSid body: tools.body outputParameters: - type: object mapping: $. - name: listunderstandmodelbuild description: listunderstandmodelbuild hints: readOnly: true destructive: false idempotent: true call: assistant-understand.listunderstandmodelbuild with: AssistantSid: tools.AssistantSid PageSize: tools.PageSize Page: tools.Page PageToken: tools.PageToken outputParameters: - type: object mapping: $. - name: createunderstandmodelbuild description: createunderstandmodelbuild hints: readOnly: false destructive: false idempotent: false call: assistant-understand.createunderstandmodelbuild with: AssistantSid: tools.AssistantSid body: tools.body outputParameters: - type: object mapping: $. - name: fetchunderstandmodelbuild description: fetchunderstandmodelbuild hints: readOnly: true destructive: false idempotent: true call: assistant-understand.fetchunderstandmodelbuild with: AssistantSid: tools.AssistantSid Sid: tools.Sid outputParameters: - type: object mapping: $. - name: updateunderstandmodelbuild description: updateunderstandmodelbuild hints: readOnly: false destructive: false idempotent: false call: assistant-understand.updateunderstandmodelbuild with: AssistantSid: tools.AssistantSid Sid: tools.Sid body: tools.body outputParameters: - type: object mapping: $. - name: deleteunderstandmodelbuild description: deleteunderstandmodelbuild hints: readOnly: false destructive: true idempotent: true call: assistant-understand.deleteunderstandmodelbuild with: AssistantSid: tools.AssistantSid Sid: tools.Sid outputParameters: - type: object mapping: $. - name: listunderstandquery description: listunderstandquery hints: readOnly: true destructive: false idempotent: true call: assistant-understand.listunderstandquery with: AssistantSid: tools.AssistantSid Language: tools.Language ModelBuild: tools.ModelBuild Status: tools.Status PageSize: tools.PageSize Page: tools.Page PageToken: tools.PageToken outputParameters: - type: object mapping: $. - name: createunderstandquery description: createunderstandquery hints: readOnly: true destructive: false idempotent: false call: assistant-understand.createunderstandquery with: AssistantSid: tools.AssistantSid body: tools.body outputParameters: - type: object mapping: $. - name: fetchunderstandquery description: fetchunderstandquery hints: readOnly: true destructive: false idempotent: true call: assistant-understand.fetchunderstandquery with: AssistantSid: tools.AssistantSid Sid: tools.Sid outputParameters: - type: object mapping: $. - name: updateunderstandquery description: updateunderstandquery hints: readOnly: true destructive: false idempotent: false call: assistant-understand.updateunderstandquery with: AssistantSid: tools.AssistantSid Sid: tools.Sid body: tools.body outputParameters: - type: object mapping: $. - name: deleteunderstandquery description: deleteunderstandquery hints: readOnly: false destructive: true idempotent: true call: assistant-understand.deleteunderstandquery with: AssistantSid: tools.AssistantSid Sid: tools.Sid outputParameters: - type: object mapping: $. - name: returns-style-sheet-json-object description: Returns Style sheet JSON object for this Assistant hints: readOnly: true destructive: false idempotent: true call: assistant-understand.fetchunderstandstylesheet with: AssistantSid: tools.AssistantSid outputParameters: - type: object mapping: $. - name: updates-style-sheet-assistant-identified description: Updates the style sheet for an assistant identified by {AssistantSid} or {AssistantUniqueName}. hints: readOnly: false destructive: false idempotent: false call: assistant-understand.updateunderstandstylesheet with: AssistantSid: tools.AssistantSid body: tools.body outputParameters: - type: object mapping: $. - name: listunderstandtask description: listunderstandtask hints: readOnly: true destructive: false idempotent: true call: assistant-understand.listunderstandtask with: AssistantSid: tools.AssistantSid PageSize: tools.PageSize Page: tools.Page PageToken: tools.PageToken outputParameters: - type: object mapping: $. - name: createunderstandtask description: createunderstandtask hints: readOnly: false destructive: false idempotent: false call: assistant-understand.createunderstandtask with: AssistantSid: tools.AssistantSid body: tools.body outputParameters: - type: object mapping: $. - name: fetchunderstandtask description: fetchunderstandtask hints: readOnly: true destructive: false idempotent: true call: assistant-understand.fetchunderstandtask with: AssistantSid: tools.AssistantSid Sid: tools.Sid outputParameters: - type: object mapping: $. - name: updateunderstandtask description: updateunderstandtask hints: readOnly: false destructive: false idempotent: false call: assistant-understand.updateunderstandtask with: AssistantSid: tools.AssistantSid Sid: tools.Sid body: tools.body outputParameters: - type: object mapping: $. - name: deleteunderstandtask description: deleteunderstandtask hints: readOnly: false destructive: true idempotent: true call: assistant-understand.deleteunderstandtask with: AssistantSid: tools.AssistantSid Sid: tools.Sid outputParameters: - type: object mapping: $. - name: returns-json-actions-this-task description: Returns JSON actions for this Task. hints: readOnly: true destructive: false idempotent: true call: assistant-understand.fetchunderstandtaskactions with: AssistantSid: tools.AssistantSid TaskSid: tools.TaskSid outputParameters: - type: object mapping: $. - name: updates-actions-task-identified-tasksid description: Updates the actions of an Task identified by {TaskSid} or {TaskUniqueName}. hints: readOnly: false destructive: false idempotent: false call: assistant-understand.updateunderstandtaskactions with: AssistantSid: tools.AssistantSid TaskSid: tools.TaskSid body: tools.body outputParameters: - type: object mapping: $. - name: listunderstandfield description: listunderstandfield hints: readOnly: true destructive: false idempotent: true call: assistant-understand.listunderstandfield with: AssistantSid: tools.AssistantSid TaskSid: tools.TaskSid PageSize: tools.PageSize Page: tools.Page PageToken: tools.PageToken outputParameters: - type: object mapping: $. - name: createunderstandfield description: createunderstandfield hints: readOnly: false destructive: false idempotent: false call: assistant-understand.createunderstandfield with: AssistantSid: tools.AssistantSid TaskSid: tools.TaskSid body: tools.body outputParameters: - type: object mapping: $. - name: fetchunderstandfield description: fetchunderstandfield hints: readOnly: true destructive: false idempotent: true call: assistant-understand.fetchunderstandfield with: AssistantSid: tools.AssistantSid TaskSid: tools.TaskSid Sid: tools.Sid outputParameters: - type: object mapping: $. - name: deleteunderstandfield description: deleteunderstandfield hints: readOnly: false destructive: true idempotent: true call: assistant-understand.deleteunderstandfield with: AssistantSid: tools.AssistantSid TaskSid: tools.TaskSid Sid: tools.Sid outputParameters: - type: object mapping: $. - name: listunderstandsample description: listunderstandsample hints: readOnly: true destructive: false idempotent: true call: assistant-understand.listunderstandsample with: AssistantSid: tools.AssistantSid TaskSid: tools.TaskSid Language: tools.Language PageSize: tools.PageSize Page: tools.Page PageToken: tools.PageToken outputParameters: - type: object mapping: $. - name: createunderstandsample description: createunderstandsample hints: readOnly: false destructive: false idempotent: false call: assistant-understand.createunderstandsample with: AssistantSid: tools.AssistantSid TaskSid: tools.TaskSid body: tools.body outputParameters: - type: object mapping: $. - name: fetchunderstandsample description: fetchunderstandsample hints: readOnly: true destructive: false idempotent: true call: assistant-understand.fetchunderstandsample with: AssistantSid: tools.AssistantSid TaskSid: tools.TaskSid Sid: tools.Sid outputParameters: - type: object mapping: $. - name: updateunderstandsample description: updateunderstandsample hints: readOnly: false destructive: false idempotent: false call: assistant-understand.updateunderstandsample with: AssistantSid: tools.AssistantSid TaskSid: tools.TaskSid Sid: tools.Sid body: tools.body outputParameters: - type: object mapping: $. - name: deleteunderstandsample description: deleteunderstandsample hints: readOnly: false destructive: true idempotent: true call: assistant-understand.deleteunderstandsample with: AssistantSid: tools.AssistantSid TaskSid: tools.TaskSid Sid: tools.Sid outputParameters: - type: object mapping: $. - name: fetchunderstandtaskstatistics description: fetchunderstandtaskstatistics hints: readOnly: true destructive: false idempotent: true call: assistant-understand.fetchunderstandtaskstatistics with: AssistantSid: tools.AssistantSid TaskSid: tools.TaskSid outputParameters: - type: object mapping: $. - name: fetchunderstandassistant description: fetchunderstandassistant hints: readOnly: true destructive: false idempotent: true call: assistant-understand.fetchunderstandassistant with: Sid: tools.Sid outputParameters: - type: object mapping: $. - name: updateunderstandassistant description: updateunderstandassistant hints: readOnly: false destructive: false idempotent: false call: assistant-understand.updateunderstandassistant with: Sid: tools.Sid body: tools.body outputParameters: - type: object mapping: $. - name: deleteunderstandassistant description: deleteunderstandassistant hints: readOnly: false destructive: true idempotent: true call: assistant-understand.deleteunderstandassistant with: Sid: tools.Sid outputParameters: - type: object mapping: $.