Twilio Understand API

openapi: 3.0.1
info:
  title: Twilio - Accounts A2p Understand API
  description: This is the public Twilio REST API.
  termsOfService: https://www.twilio.com/legal/tos
  contact:
    name: Twilio Support
    url: https://support.twilio.com
    email: support@twilio.com
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  version: 1.52.0
servers:
- url: https://accounts.twilio.com
tags:
- name: Understand
paths:
  /understand/Assistants/{Sid}:
    servers:
    - url: https://preview.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: instance
      dependentProperties:
        field_types:
          mapping:
            assistant_sid: sid
          resource_url: /understand/Assistants/{assistant_sid}/FieldTypes
        tasks:
          mapping:
            assistant_sid: sid
          resource_url: /understand/Assistants/{assistant_sid}/Tasks
        model_builds:
          mapping:
            assistant_sid: sid
          resource_url: /understand/Assistants/{assistant_sid}/ModelBuilds
        queries:
          mapping:
            assistant_sid: sid
          resource_url: /understand/Assistants/{assistant_sid}/Queries
        assistant_fallback_actions:
          mapping:
            assistant_sid: sid
          resource_url: /understandNone
        assistant_initiation_actions:
          mapping:
            assistant_sid: sid
          resource_url: /understandNone
        dialogues:
          mapping:
            assistant_sid: sid
          resource_url: /understand/Assistants/{assistant_sid}/Dialogues
        style_sheet:
          mapping:
            assistant_sid: sid
          resource_url: /understandNone
    get:
      description: ''
      tags:
      - Understand
      parameters:
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource.
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchUnderstandAssistant
      x-maturity:
      - Preview
    post:
      description: ''
      tags:
      - Understand
      parameters:
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource.
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: UpdateUnderstandAssistant
      x-maturity:
      - Preview
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/UpdateUnderstandAssistantRequest'
    delete:
      description: ''
      tags:
      - Understand
      parameters:
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource.
        schema:
          type: string
        required: true
      responses:
        '204':
          description: The resource was deleted successfully.
      security:
      - accountSid_authToken: []
      operationId: DeleteUnderstandAssistant
      x-maturity:
      - Preview
  /understand/Assistants/{AssistantSid}/FallbackActions:
    servers:
    - url: https://preview.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: instance
      parent: /Assistants/{Sid}
      mountName: assistant_fallback_actions
      className: assistant_fallback_actions
    get:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant.assistant_fallback_actions'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchUnderstandAssistantFallbackActions
      x-maturity:
      - Preview
    post:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant.assistant_fallback_actions'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: UpdateUnderstandAssistantFallbackActions
      x-maturity:
      - Preview
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/UpdateUnderstandAssistantFallbackActionsRequest'
  /understand/Assistants/{AssistantSid}/InitiationActions:
    servers:
    - url: https://preview.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: instance
      parent: /Assistants/{Sid}
      mountName: assistant_initiation_actions
      className: assistant_initiation_actions
    get:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant.assistant_initiation_actions'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchUnderstandAssistantInitiationActions
      x-maturity:
      - Preview
    post:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant.assistant_initiation_actions'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: UpdateUnderstandAssistantInitiationActions
      x-maturity:
      - Preview
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/UpdateUnderstandAssistantInitiationActionsRequest'
  /understand/Assistants/{AssistantSid}/Dialogues/{Sid}:
    servers:
    - url: https://preview.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: instance
      parent: /Assistants/{Sid}
    get:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: ''
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant.dialogue'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchUnderstandDialogue
      x-maturity:
      - Preview
  /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Fields/{Sid}:
    servers:
    - url: https://preview.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: instance
      parent: /Assistants/{AssistantSid}/Tasks/{Sid}
    get:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: The unique ID of the Assistant.
        schema:
          type: string
        required: true
      - name: TaskSid
        in: path
        description: The unique ID of the Task associated with this Field.
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource.
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant.task.field'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchUnderstandField
      x-maturity:
      - Preview
    delete:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: The unique ID of the Assistant.
        schema:
          type: string
        required: true
      - name: TaskSid
        in: path
        description: The unique ID of the Task associated with this Field.
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource.
        schema:
          type: string
        required: true
      responses:
        '204':
          description: The resource was deleted successfully.
      security:
      - accountSid_authToken: []
      operationId: DeleteUnderstandField
      x-maturity:
      - Preview
  /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Fields:
    servers:
    - url: https://preview.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: list
      parent: /Assistants/{AssistantSid}/Tasks/{Sid}
    get:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: The unique ID of the Assistant.
        schema:
          type: string
        required: true
      - name: TaskSid
        in: path
        description: The unique ID of the Task associated with this Field.
        schema:
          type: string
        required: true
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListUnderstandFieldResponse'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListUnderstandField
      x-maturity:
      - Preview
    post:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: The unique ID of the parent Assistant.
        schema:
          type: string
        required: true
      - name: TaskSid
        in: path
        description: The unique ID of the Task associated with this Field.
        schema:
          type: string
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant.task.field'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateUnderstandField
      x-maturity:
      - Preview
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/CreateUnderstandFieldRequest'
  /understand/Assistants/{AssistantSid}/FieldTypes/{Sid}:
    servers:
    - url: https://preview.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: instance
      dependentProperties:
        field_values:
          mapping:
            assistant_sid: assistant_sid
            field_type_sid: sid
          resource_url: /understand/Assistants/{assistant_sid}/FieldTypes/{field_type_sid}/FieldValues
      parent: /Assistants/{Sid}
    get:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: ''
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant.field_type'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchUnderstandFieldType
      x-maturity:
      - Preview
    post:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: ''
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant.field_type'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: UpdateUnderstandFieldType
      x-maturity:
      - Preview
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/UpdateUnderstandFieldTypeRequest'
    delete:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: ''
        schema:
          type: string
        required: true
      responses:
        '204':
          description: The resource was deleted successfully.
      security:
      - accountSid_authToken: []
      operationId: DeleteUnderstandFieldType
      x-maturity:
      - Preview
  /understand/Assistants/{AssistantSid}/FieldTypes:
    servers:
    - url: https://preview.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: list
      dependentProperties:
        field_values:
          mapping:
            assistant_sid: assistant_sid
            field_type_sid: sid
          resource_url: /understand/Assistants/{assistant_sid}/FieldTypes/{field_type_sid}/FieldValues
      parent: /Assistants/{Sid}
    get:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListUnderstandFieldTypeResponse'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListUnderstandFieldType
      x-maturity:
      - Preview
    post:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant.field_type'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateUnderstandFieldType
      x-maturity:
      - Preview
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/CreateUnderstandFieldTypeRequest'
  /understand/Assistants/{AssistantSid}/FieldTypes/{FieldTypeSid}/FieldValues/{Sid}:
    servers:
    - url: https://preview.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: instance
      parent: /Assistants/{AssistantSid}/FieldTypes/{Sid}
    get:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      - name: FieldTypeSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: ''
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant.field_type.field_value'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchUnderstandFieldValue
      x-maturity:
      - Preview
    delete:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      - name: FieldTypeSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: ''
        schema:
          type: string
        required: true
      responses:
        '204':
          description: The resource was deleted successfully.
      security:
      - accountSid_authToken: []
      operationId: DeleteUnderstandFieldValue
      x-maturity:
      - Preview
  /understand/Assistants/{AssistantSid}/FieldTypes/{FieldTypeSid}/FieldValues:
    servers:
    - url: https://preview.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: list
      parent: /Assistants/{AssistantSid}/FieldTypes/{Sid}
    get:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      - name: FieldTypeSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      - name: Language
        in: query
        description: 'An ISO language-country string of the value. For example: *en-US*'
        schema:
          type: string
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListUnderstandFieldValueResponse'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListUnderstandFieldValue
      x-maturity:
      - Preview
    post:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      - name: FieldTypeSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant.field_type.field_value'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateUnderstandFieldValue
      x-maturity:
      - Preview
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/CreateUnderstandFieldValueRequest'
  /understand/Assistants/{AssistantSid}/ModelBuilds/{Sid}:
    servers:
    - url: https://preview.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: instance
      parent: /Assistants/{Sid}
    get:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: ''
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant.model_build'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchUnderstandModelBuild
      x-maturity:
      - Preview
    post:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: ''
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant.model_build'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: UpdateUnderstandModelBuild
      x-maturity:
      - Preview
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/UpdateUnderstandModelBuildRequest'
    delete:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: ''
        schema:
          type: string
        required: true
      responses:
        '204':
          description: The resource was deleted successfully.
      security:
      - accountSid_authToken: []
      operationId: DeleteUnderstandModelBuild
      x-maturity:
      - Preview
  /understand/Assistants/{AssistantSid}/ModelBuilds:
    servers:
    - url: https://preview.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: list
      parent: /Assistants/{Sid}
    get:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListUnderstandModelBuildResponse'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListUnderstandModelBuild
      x-maturity:
      - Preview
    post:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: ''
        schema:
          type: string
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant.model_build'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateUnderstandModelBuild
      x-maturity:
      - Preview
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/CreateUnderstandModelBuildRequest'
  /understand/Assistants/{AssistantSid}/Queries/{Sid}:
    servers:
    - url: https://preview.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: instance
      parent: /Assistants/{Sid}
    get:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: The unique ID of the Assistant.
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource.
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant.query'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchUnderstandQuery
      x-maturity:
      - Preview
    post:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: The unique ID of the parent Assistant.
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource.
        schema:
          type: string
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant.query'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: UpdateUnderstandQuery
      x-maturity:
      - Preview
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/UpdateUnderstandQueryRequest'
    delete:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: The unique ID of the Assistant.
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource.
        schema:
          type: string
        required: true
      responses:
        '204':
          description: The resource was deleted successfully.
      security:
      - accountSid_authToken: []
      operationId: DeleteUnderstandQuery
      x-maturity:
      - Preview
  /understand/Assistants/{AssistantSid}/Queries:
    servers:
    - url: https://preview.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: list
      parent: /Assistants/{Sid}
    get:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: The unique ID of the parent Assistant.
        schema:
          type: string
        required: true
      - name: Language
        in: query
        description: An ISO language-country string of the sample.
        schema:
          type: string
      - name: ModelBuild
        in: query
        description: The Model Build Sid or unique name of the Model Build to be queried.
        schema:
          type: string
      - name: Status
        in: query
        description: 'A string that described the query status. The values can be: pending_review, reviewed, discarded'
        schema:
          type: string
      - name: PageSize
        in: query
        description: How many resources to return in each list page. The default is 50, and the maximum is 1000.
        schema:
          type: integer
          minimum: 1
          maximum: 1000
      - name: Page
        in: query
        description: The page index. This value is simply for client state.
        schema:
          type: integer
          minimum: 0
      - name: PageToken
        in: query
        description: The page token. This is provided by the API.
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListUnderstandQueryResponse'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: ListUnderstandQuery
      x-maturity:
      - Preview
    post:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: The unique ID of the parent Assistant.
        schema:
          type: string
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant.query'
          description: Created
      security:
      - accountSid_authToken: []
      operationId: CreateUnderstandQuery
      x-maturity:
      - Preview
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/CreateUnderstandQueryRequest'
  /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Samples/{Sid}:
    servers:
    - url: https://preview.twilio.com
    description: 'TODO: Resource-level docs'
    x-twilio:
      defaultOutputProperties: []
      pathType: instance
      parent: /Assistants/{AssistantSid}/Tasks/{Sid}
    get:
      description: ''
      tags:
      - Understand
      parameters:
      - name: AssistantSid
        in: path
        description: The unique ID of the Assistant.
        schema:
          type: string
        required: true
      - name: TaskSid
        in: path
        description: The unique ID of the Task associated with this Sample.
        schema:
          type: string
        required: true
      - name: Sid
        in: path
        description: A 34 character string that uniquely identifies this resource.
        schema:
          type: string
          minLength: 34
          maxLength: 34
          pattern: ^UF[0-9a-fA-F]{32}$
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/preview.understand.assistant.task.sample'
          description: OK
      security:
      - accountSid_authToken: []
      operationId: FetchUnderstandSample


# --- truncated at 32 KB (82 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/twilio/refs/heads/main/openapi/twilio-understand-api-openapi.yml