API Evangelist conversational phrasing for Twilio - Autopilot Assistants API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Twilio - Autopilot Assistants API
  version: 1.0.0
extends: openapi/twilio-assistants-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 52
- target: $.paths['/v1/Assistants/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up an Autopilot assistant
      effect: read
      questions:
      - How do I see the settings of one Autopilot assistant I already built?
      - Can I check whether a specific virtual assistant is logging queries after training?
      instructions:
      - text: Show me the details of Autopilot assistant {assistant}.
        slots:
          assistant: path.Sid
      - text: Pull up assistant {assistant} and tell me its development stage.
        slots:
          assistant: path.Sid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{Sid}'].post
  update:
    x-apievangelist-phrasing:
      intent: Change an Autopilot assistant's settings
      effect: write
      questions:
      - Can I rename an existing Autopilot assistant without rebuilding it?
      - Is it possible to turn off query logging on an assistant that's already live?
      instructions:
      - text: Rename assistant {assistant} to {friendly_name}.
        slots:
          assistant: path.Sid
          friendly_name: requestBody.FriendlyName
      - text: 'Stop keeping logged queries after training on assistant {assistant}: set log queries to {log_queries}.'
        slots:
          assistant: path.Sid
          log_queries: requestBody.LogQueries
      - text: Move assistant {assistant} to development stage {stage}.
        slots:
          assistant: path.Sid
          stage: requestBody.DevelopmentStage
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{Sid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an Autopilot assistant
      effect: destructive
      questions:
      - How do I permanently remove a virtual assistant I no longer use?
      - What happens to an Autopilot bot when I delete the whole assistant?
      instructions:
      - text: Delete Autopilot assistant {assistant}.
        slots:
          assistant: path.Sid
      - text: Tear down the whole bot {assistant}, it is retired.
        slots:
          assistant: path.Sid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants'].get
  update:
    x-apievangelist-phrasing:
      intent: List my Autopilot assistants
      effect: read
      questions:
      - Which Autopilot assistants exist on my Twilio account?
      - Can I page through all my virtual assistants a thousand at a time?
      instructions:
      - text: List every Autopilot assistant on my account.
      - text: Show my assistants, {page_size} per page.
        slots:
          page_size: query.PageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new Autopilot assistant
      effect: write
      questions:
      - How do I start building a new intelligent virtual assistant from scratch?
      - Can I give a brand-new bot a style sheet and default tasks at creation time?
      instructions:
      - text: Create a new Autopilot assistant called {friendly_name}.
        slots:
          friendly_name: requestBody.FriendlyName
      - text: Spin up a new assistant with unique name {unique_name} and default tasks {defaults}.
        slots:
          unique_name: requestBody.UniqueName
          defaults: requestBody.Defaults
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/Defaults'].get
  update:
    x-apievangelist-phrasing:
      intent: See an assistant's default tasks
      effect: read
      questions:
      - Which task does my assistant fall back to when it doesn't understand the user?
      - What task runs when a conversation with my bot first starts?
      instructions:
      - text: Show the default task links for assistant {assistant}.
        slots:
          assistant: path.AssistantSid
      - text: Tell me which fallback and initiation tasks assistant {assistant} uses.
        slots:
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/Defaults'].post
  update:
    x-apievangelist-phrasing:
      intent: Set an assistant's default tasks
      effect: write
      questions:
      - Can I change the fallback task my bot uses when it can't match an intent?
      - How do I point assistant initiation at a different task?
      instructions:
      - text: Replace the default task links on assistant {assistant} with {defaults}.
        slots:
          assistant: path.AssistantSid
          defaults: requestBody.Defaults
      - text: Set the fallback and collect defaults for assistant {assistant} to {defaults}.
        slots:
          assistant: path.AssistantSid
          defaults: requestBody.Defaults
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/Dialogues/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read one assistant dialogue
      effect: read
      questions:
      - Can I review a single conversation my Autopilot bot had with an end user?
      - Where do I see the full dialogue behind one of my assistant's sessions?
      instructions:
      - text: Show dialogue {dialogue} from assistant {assistant}.
        slots:
          dialogue: path.Sid
          assistant: path.AssistantSid
      - text: Open conversation record {dialogue} on bot {assistant} so I can review it.
        slots:
          dialogue: path.Sid
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/Tasks/{TaskSid}/Fields/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a field on an assistant task
      effect: read
      questions:
      - How do I check what field type a task's field is expecting?
      - Can I inspect one input field defined on an Autopilot task?
      instructions:
      - text: Show field {field} on task {task} of assistant {assistant}.
        slots:
          field: path.Sid
          task: path.TaskSid
          assistant: path.AssistantSid
      - text: Tell me the field type of field {field} in task {task}, assistant {assistant}.
        slots:
          field: path.Sid
          task: path.TaskSid
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/Tasks/{TaskSid}/Fields/{Sid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a field from an assistant task
      effect: destructive
      questions:
      - Can I drop a field a task no longer needs to collect?
      - How do I stop an Autopilot task from extracting a particular value?
      instructions:
      - text: Delete field {field} from task {task} on assistant {assistant}.
        slots:
          field: path.Sid
          task: path.TaskSid
          assistant: path.AssistantSid
      - text: Remove the field {field} that task {task} collects in bot {assistant}.
        slots:
          field: path.Sid
          task: path.TaskSid
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/Tasks/{TaskSid}/Fields'].get
  update:
    x-apievangelist-phrasing:
      intent: List the fields on an assistant task
      effect: read
      questions:
      - Which fields does a given task in my bot extract from what users say?
      - What values is one of my Autopilot tasks set up to capture?
      instructions:
      - text: List all fields on task {task} of assistant {assistant}.
        slots:
          task: path.TaskSid
          assistant: path.AssistantSid
      - text: Show every field task {task} collects in bot {assistant}, {page_size} at a time.
        slots:
          task: path.TaskSid
          assistant: path.AssistantSid
          page_size: query.PageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/Tasks/{TaskSid}/Fields'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a field to an assistant task
      effect: write
      questions:
      - How do I make a task capture a value like a date or a city from the user?
      - Can a task field use a built-in field type or only my custom ones?
      instructions:
      - text: Add a field named {unique_name} of type {field_type} to task {task} on assistant {assistant}.
        slots:
          unique_name: requestBody.UniqueName
          field_type: requestBody.FieldType
          task: path.TaskSid
          assistant: path.AssistantSid
      - text: Make task {task} in bot {assistant} collect a new {field_type} field.
        slots:
          task: path.TaskSid
          assistant: path.AssistantSid
          field_type: requestBody.FieldType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/FieldTypes/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a custom field type
      effect: read
      questions:
      - How can I view one of the custom field types I defined for my assistant?
      - Can I check the friendly name of a field type my bot uses?
      instructions:
      - text: Show custom field type {field_type} on assistant {assistant}.
        slots:
          field_type: path.Sid
          assistant: path.AssistantSid
      - text: Get the details of field type {field_type} in bot {assistant}.
        slots:
          field_type: path.Sid
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/FieldTypes/{Sid}'].post
  update:
    x-apievangelist-phrasing:
      intent: Rename a custom field type
      effect: write
      questions:
      - Can I rename a custom field type without recreating its values?
      - Is it possible to change the unique name of a field type my tasks already use?
      instructions:
      - text: Rename field type {field_type} on assistant {assistant} to {friendly_name}.
        slots:
          field_type: path.Sid
          assistant: path.AssistantSid
          friendly_name: requestBody.FriendlyName
      - text: Change the unique name of field type {field_type} in bot {assistant} to {unique_name}.
        slots:
          field_type: path.Sid
          assistant: path.AssistantSid
          unique_name: requestBody.UniqueName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/FieldTypes/{Sid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom field type
      effect: destructive
      questions:
      - How do I get rid of a custom field type my assistant no longer needs?
      - Can I remove a whole custom field type along with its vocabulary?
      instructions:
      - text: Delete custom field type {field_type} from assistant {assistant}.
        slots:
          field_type: path.Sid
          assistant: path.AssistantSid
      - text: Remove the field type {field_type} from bot {assistant} entirely.
        slots:
          field_type: path.Sid
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/FieldTypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List an assistant's custom field types
      effect: read
      questions:
      - What custom field types have I defined for my virtual assistant?
      - Which custom vocabularies can my bot's task fields draw on?
      instructions:
      - text: List all custom field types on assistant {assistant}.
        slots:
          assistant: path.AssistantSid
      - text: Show the field types bot {assistant} has, {page_size} per page.
        slots:
          assistant: path.AssistantSid
          page_size: query.PageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/FieldTypes'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a custom field type
      effect: write
      questions:
      - How do I define my own field type, like a list of product names, for my bot?
      - Can I create a custom vocabulary for an Autopilot assistant to recognize?
      instructions:
      - text: Create a custom field type {unique_name} on assistant {assistant}.
        slots:
          unique_name: requestBody.UniqueName
          assistant: path.AssistantSid
      - text: Add a new field type named {unique_name} with label {friendly_name} to bot {assistant}.
        slots:
          unique_name: requestBody.UniqueName
          friendly_name: requestBody.FriendlyName
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/FieldTypes/{FieldTypeSid}/FieldValues/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up one value of a field type
      effect: read
      questions:
      - Can I check a single entry in one of my custom field types?
      - How do I see whether a field value is a synonym of another word?
      instructions:
      - text: Show field value {field_value} of field type {field_type} on assistant {assistant}.
        slots:
          field_value: path.Sid
          field_type: path.FieldTypeSid
          assistant: path.AssistantSid
      - text: Get entry {field_value} in field type {field_type} for bot {assistant}.
        slots:
          field_value: path.Sid
          field_type: path.FieldTypeSid
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/FieldTypes/{FieldTypeSid}/FieldValues/{Sid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a value from a field type
      effect: destructive
      questions:
      - How do I take one word out of a custom field type's vocabulary?
      - Can I delete a single synonym without touching the rest of the field type?
      instructions:
      - text: Delete field value {field_value} from field type {field_type} on assistant {assistant}.
        slots:
          field_value: path.Sid
          field_type: path.FieldTypeSid
          assistant: path.AssistantSid
      - text: Remove entry {field_value} from vocabulary {field_type} in bot {assistant}.
        slots:
          field_value: path.Sid
          field_type: path.FieldTypeSid
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/FieldTypes/{FieldTypeSid}/FieldValues'].get
  update:
    x-apievangelist-phrasing:
      intent: List the values in a field type
      effect: read
      questions:
      - What words and synonyms are in one of my custom field types?
      - Can I list a field type's values for just one language, like en-US?
      instructions:
      - text: List every value in field type {field_type} on assistant {assistant}.
        slots:
          field_type: path.FieldTypeSid
          assistant: path.AssistantSid
      - text: Show the {language} values of field type {field_type} in bot {assistant}.
        slots:
          language: query.Language
          field_type: path.FieldTypeSid
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/FieldTypes/{FieldTypeSid}/FieldValues'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a value or synonym to a field type
      effect: write
      questions:
      - How do I teach my bot a new word for a custom field type?
      - Can I add a synonym so two words map to the same field value?
      instructions:
      - text: Add the {language} value {value} to field type {field_type} on assistant {assistant}.
        slots:
          language: requestBody.Language
          value: requestBody.Value
          field_type: path.FieldTypeSid
          assistant: path.AssistantSid
      - text: Add {value} as a synonym of {synonym_of} in field type {field_type}, bot {assistant}.
        slots:
          value: requestBody.Value
          synonym_of: requestBody.SynonymOf
          field_type: path.FieldTypeSid
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/ModelBuilds/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a model build
      effect: read
      questions:
      - Has my assistant finished training its latest model build?
      - How do I check the status of one model build?
      instructions:
      - text: Show model build {build} for assistant {assistant}.
        slots:
          build: path.Sid
          assistant: path.AssistantSid
      - text: Tell me whether training build {build} on bot {assistant} is done.
        slots:
          build: path.Sid
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/ModelBuilds/{Sid}'].post
  update:
    x-apievangelist-phrasing:
      intent: Rename a model build
      effect: write
      questions:
      - Can I give an existing model build a friendlier unique name like v0.1?
      - Is renaming a trained model build possible after it's created?
      instructions:
      - text: Rename model build {build} on assistant {assistant} to {unique_name}.
        slots:
          build: path.Sid
          assistant: path.AssistantSid
          unique_name: requestBody.UniqueName
      - text: Label training build {build} in bot {assistant} as {unique_name}.
        slots:
          build: path.Sid
          assistant: path.AssistantSid
          unique_name: requestBody.UniqueName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/ModelBuilds/{Sid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a model build
      effect: destructive
      questions:
      - How do I clean up old model builds I no longer need?
      - Can I delete one trained model version from my assistant?
      instructions:
      - text: Delete model build {build} from assistant {assistant}.
        slots:
          build: path.Sid
          assistant: path.AssistantSid
      - text: Remove the old training build {build} on bot {assistant}.
        slots:
          build: path.Sid
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/ModelBuilds'].get
  update:
    x-apievangelist-phrasing:
      intent: List an assistant's model builds
      effect: read
      questions:
      - What model builds has my assistant been trained into so far?
      - Can I see the history of training runs for my bot?
      instructions:
      - text: List all model builds for assistant {assistant}.
        slots:
          assistant: path.AssistantSid
      - text: Show the training build history of bot {assistant}, {page_size} per page.
        slots:
          assistant: path.AssistantSid
          page_size: query.PageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/ModelBuilds'].post
  update:
    x-apievangelist-phrasing:
      intent: Train a new model build
      effect: write
      questions:
      - How do I retrain my Autopilot assistant after changing its tasks and samples?
      - Can I get a callback when a new model build finishes training?
      instructions:
      - text: Start a new model build for assistant {assistant}.
        slots:
          assistant: path.AssistantSid
      - text: Train bot {assistant} into a build named {unique_name} and post status to {status_callback}.
        slots:
          assistant: path.AssistantSid
          unique_name: requestBody.UniqueName
          status_callback: requestBody.StatusCallback
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/Queries/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a query sent to an assistant
      effect: read
      questions:
      - How do I see how my assistant interpreted one specific user utterance?
      - Can I check the review status of a single logged query?
      instructions:
      - text: Show query {query} on assistant {assistant}.
        slots:
          query: path.Sid
          assistant: path.AssistantSid
      - text: Tell me which task bot {assistant} matched for query {query}.
        slots:
          assistant: path.AssistantSid
          query: path.Sid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/Queries/{Sid}'].post
  update:
    x-apievangelist-phrasing:
      intent: Review or discard a logged query
      effect: write
      questions:
      - Can I mark a user query as reviewed after checking what the bot did?
      - How do I discard a logged query so it doesn't count in training review?
      instructions:
      - text: Mark query {query} on assistant {assistant} as {status}.
        slots:
          query: path.Sid
          assistant: path.AssistantSid
          status: requestBody.Status
      - text: Link query {query} in bot {assistant} to sample {sample}.
        slots:
          query: path.Sid
          assistant: path.AssistantSid
          sample: requestBody.SampleSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/Queries/{Sid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a logged query
      effect: destructive
      questions:
      - How do I permanently delete one end-user query my assistant logged?
      - Can I erase a single utterance from my bot's query log?
      instructions:
      - text: Delete query {query} from assistant {assistant}.
        slots:
          query: path.Sid
          assistant: path.AssistantSid
      - text: Erase the logged utterance {query} in bot {assistant}.
        slots:
          query: path.Sid
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/Queries'].get
  update:
    x-apievangelist-phrasing:
      intent: List queries an assistant received
      effect: read
      questions:
      - Which user queries are still waiting for review on my assistant?
      - Can I filter logged queries by language or by the model build that handled them?
      - What did users say during one particular dialogue with my bot?
      instructions:
      - text: List the queries on assistant {assistant} with status {status}.
        slots:
          assistant: path.AssistantSid
          status: query.Status
      - text: Show queries bot {assistant} answered with model build {model_build}.
        slots:
          assistant: path.AssistantSid
          model_build: query.ModelBuild
      - text: Show every query from dialogue {dialogue} on assistant {assistant}.
        slots:
          dialogue: query.DialogueSid
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/Queries'].post
  update:
    x-apievangelist-phrasing:
      intent: Test an assistant with a query
      effect: write
      questions:
      - How do I test what my trained assistant does with a sentence a user might type?
      - Can I run a test query against only a few of my bot's tasks?
      instructions:
      - text: Send the {language} query {text} to assistant {assistant}.
        slots:
          language: requestBody.Language
          text: requestBody.Query
          assistant: path.AssistantSid
      - text: Test bot {assistant} with {text} in {language}, limited to tasks {tasks}.
        slots:
          assistant: path.AssistantSid
          text: requestBody.Query
          language: requestBody.Language
          tasks: requestBody.Tasks
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/Restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore an Autopilot assistant
      effect: write
      questions:
      - Can I bring back an Autopilot assistant after it was removed?
      - How do I restore a virtual assistant by its SID?
      instructions:
      - text: Restore Autopilot assistant {assistant}.
        slots:
          assistant: requestBody.Assistant
      - text: Bring bot {assistant} back into service with a restore.
        slots:
          assistant: requestBody.Assistant
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/Tasks/{TaskSid}/Samples/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a training sample
      effect: read
      questions:
      - How do I view one example utterance I trained a task on?
      - Can I see which channel a specific training sample came from?
      instructions:
      - text: Show sample {sample} on task {task} of assistant {assistant}.
        slots:
          sample: path.Sid
          task: path.TaskSid
          assistant: path.AssistantSid
      - text: Get training phrase {sample} for task {task} in bot {assistant}.
        slots:
          sample: path.Sid
          task: path.TaskSid
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/Tasks/{TaskSid}/Samples/{Sid}'].post
  update:
    x-apievangelist-phrasing:
      intent: Edit a training sample
      effect: write
      questions:
      - Can I fix the wording of a training sample I already added?
      - How do I change the source channel recorded on an existing sample?
      instructions:
      - text: Change the text of sample {sample} on task {task}, assistant {assistant}, to {tagged_text}.
        slots:
          sample: path.Sid
          task: path.TaskSid
          assistant: path.AssistantSid
          tagged_text: requestBody.TaggedText
      - text: Set the source channel of existing sample {sample} in task {task}, bot {assistant}, to {channel}.
        slots:
          sample: path.Sid
          task: path.TaskSid
          assistant: path.AssistantSid
          channel: requestBody.SourceChannel
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/Tasks/{TaskSid}/Samples/{Sid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a training sample
      effect: destructive
      questions:
      - How do I remove a bad example phrase that's confusing my bot's training?
      - Can I delete one sample without deleting the task it belongs to?
      instructions:
      - text: Delete sample {sample} from task {task} on assistant {assistant}.
        slots:
          sample: path.Sid
          task: path.TaskSid
          assistant: path.AssistantSid
      - text: Remove the misleading training phrase {sample} from task {task} in bot {assistant}.
        slots:
          sample: path.Sid
          task: path.TaskSid
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/Tasks/{TaskSid}/Samples'].get
  update:
    x-apievangelist-phrasing:
      intent: List a task's training samples
      effect: read
      questions:
      - What example phrases has a task in my bot been trained on?
      - Can I list only the Spanish training samples for one task?
      instructions:
      - text: List all samples for task {task} on assistant {assistant}.
        slots:
          task: path.TaskSid
          assistant: path.AssistantSid
      - text: Show the {language} training phrases of task {task} in bot {assistant}.
        slots:
          language: query.Language
          task: path.TaskSid
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/Tasks/{TaskSid}/Samples'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a training sample to a task
      effect: write
      questions:
      - How do I teach a task another way users might phrase their request?
      - Can a training sample tag field values inside the example text?
      instructions:
      - text: Add the {language} sample {tagged_text} to task {task} on assistant {assistant}.
        slots:
          language: requestBody.Language
          tagged_text: requestBody.TaggedText
          task: path.TaskSid
          assistant: path.AssistantSid
      - text: Train task {task} in bot {assistant} on a new {language} phrase {tagged_text} heard over {channel}.
        slots:
          task: path.TaskSid
          assistant: path.AssistantSid
          language: requestBody.Language
          tagged_text: requestBody.TaggedText
          channel: requestBody.SourceChannel
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/StyleSheet'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an assistant's style sheet
      effect: read
      questions:
      - Where can I see the voice and style settings my assistant uses?
      - What does the style sheet JSON look like for my bot right now?
      instructions:
      - text: Show the style sheet for assistant {assistant}.
        slots:
          assistant: path.AssistantSid
      - text: Return the style sheet JSON of bot {assistant}.
        slots:
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/StyleSheet'].post
  update:
    x-apievangelist-phrasing:
      intent: Update an assistant's style sheet
      effect: write
      questions:
      - How do I change my bot's voice or collect-error style settings?
      - Can I replace an assistant's style sheet after it's been created?
      instructions:
      - text: Replace the style sheet of assistant {assistant} with {style_sheet}.
        slots:
          assistant: path.AssistantSid
          style_sheet: requestBody.StyleSheet
      - text: Apply style sheet JSON {style_sheet} to bot {assistant}.
        slots:
          style_sheet: requestBody.StyleSheet
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/Tasks/{Sid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up an assistant task
      effect: read
      questions:
      - How do I view one task my virtual assistant can handle?
      - Can I check which actions URL a task is pointed at?
      instructions:
      - text: Show task {task} on assistant {assistant}.
        slots:
          task: path.Sid
          assistant: path.AssistantSid
      - text: Get the details of intent task {task} in bot {assistant}.
        slots:
          task: path.Sid
          assistant: path.AssistantSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Assistants/{AssistantSid}/Tasks/{Sid}'].post
  update:
    x-apievangelist-phrasing:
      intent: Update an assistant task
      effect: write
      questions:
      - Can I rename a task or change where it fetches its actions from?
      - How do I move a task's actions to a hosted actions URL?
      instructions:
      - text: Rename task {task} on assistant {assistant} to {friendly_name}.
        slots:
          task: path.Sid
          assistant: path.AssistantSid
          friendly_name: requestBody.FriendlyName
      - text: Point task {task} in bot {assistant} at actions URL {actions_url}.
        slots:
          task: path.Sid
          assistant: path.AssistantSid
          actions_url: requestBody.ActionsUrl
      method: generated
      generated: '2026-09-26'


# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/twilio/refs/heads/main/overlays/twilio-assistants-api-phrasing-overlay.yaml