API Evangelist conversational phrasing for Twilio - Bulkexports Exports 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 - Bulkexports Exports API
  version: 1.0.0
extends: openapi/twilio-exports-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: 9
- target: $.paths['/v1/Exports/{ResourceType}/Days/{Day}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one day's export file for a resource type
      effect: read
      questions:
      - Can I download the exported message records for a single UTC day?
      - Where do I get yesterday's call export file?
      instructions:
      - text: Fetch the {resource_type} export for day {day}.
        slots:
          resource_type: path.ResourceType
          day: path.Day
      - text: Get the daily export file of {resource_type} dated {day}.
        slots:
          resource_type: path.ResourceType
          day: path.Day
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Exports/{ResourceType}/Days'].get
  update:
    x-apievangelist-phrasing:
      intent: List the daily export files available
      effect: read
      questions:
      - Which days have export files ready for my messages?
      - Can I see every available daily export for calls?
      instructions:
      - text: List the available export days for {resource_type}.
        slots:
          resource_type: path.ResourceType
      - text: Show {page_size} daily {resource_type} export files per page.
        slots:
          page_size: query.PageSize
          resource_type: path.ResourceType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Exports/{ResourceType}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up the export for a resource type
      effect: read
      questions:
      - What does the export resource for Messages link to?
      - Can I check the top-level export record for one kind of communication?
      instructions:
      - text: Fetch the export resource for {resource_type}.
        slots:
          resource_type: path.ResourceType
      - text: Show the export overview and links for {resource_type}.
        slots:
          resource_type: path.ResourceType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Exports/{ResourceType}/Configuration'].get
  update:
    x-apievangelist-phrasing:
      intent: Check automatic daily export settings
      effect: read
      questions:
      - Is automatic daily export turned on for my call records?
      - Which webhook gets notified when a message export is ready?
      instructions:
      - text: Show the export configuration for {resource_type}.
        slots:
          resource_type: path.ResourceType
      - text: Check whether daily {resource_type} exports are enabled and where they notify.
        slots:
          resource_type: path.ResourceType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Exports/{ResourceType}/Configuration'].post
  update:
    x-apievangelist-phrasing:
      intent: Turn automatic daily exports on or off
      effect: write
      questions:
      - Can I have a file generated automatically every day once the day is over?
      - Can I get a webhook when each day's export finishes?
      instructions:
      - text: Set automatic daily exports for {resource_type} to {enabled}.
        slots:
          resource_type: path.ResourceType
          enabled: requestBody.Enabled
      - text: Notify {webhook_url} via {webhook_method} when {resource_type} exports are ready.
        slots:
          webhook_url: requestBody.WebhookUrl
          webhook_method: requestBody.WebhookMethod
          resource_type: path.ResourceType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Exports/{ResourceType}/Jobs'].get
  update:
    x-apievangelist-phrasing:
      intent: List custom date-range export jobs
      effect: read
      questions:
      - Which custom export jobs have I requested for my messages?
      - Can I see the status of my date-range export jobs?
      instructions:
      - text: List the custom export jobs for {resource_type}.
        slots:
          resource_type: path.ResourceType
      - text: Show my {resource_type} date-range export jobs, {page_size} per page.
        slots:
          resource_type: path.ResourceType
          page_size: query.PageSize
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Exports/{ResourceType}/Jobs'].post
  update:
    x-apievangelist-phrasing:
      intent: Request an export for a custom date range
      effect: write
      questions:
      - Can I export a whole month of call records in one job?
      - Can I get an email when my custom export is finished?
      instructions:
      - text: Export {resource_type} from {start_day} to {end_day} as job {friendly_name}.
        slots:
          resource_type: path.ResourceType
          start_day: requestBody.StartDay
          end_day: requestBody.EndDay
          friendly_name: requestBody.FriendlyName
      - text: Start custom job {friendly_name} for {resource_type} between {start_day} and {end_day} and email {email}.
        slots:
          friendly_name: requestBody.FriendlyName
          resource_type: path.ResourceType
          start_day: requestBody.StartDay
          end_day: requestBody.EndDay
          email: requestBody.Email
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Exports/Jobs/{JobSid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check on one custom export job
      effect: read
      questions:
      - Has my custom export job finished yet?
      - Can I look up a single export job by its SID?
      instructions:
      - text: Fetch export job {job_sid}.
        slots:
          job_sid: path.JobSid
      - text: Show the progress of custom export job {job_sid}.
        slots:
          job_sid: path.JobSid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/Exports/Jobs/{JobSid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom export job
      effect: destructive
      questions:
      - Can I delete a custom export job I no longer need?
      - How do I remove an old export job from my list?
      instructions:
      - text: Delete export job {job_sid}.
        slots:
          job_sid: path.JobSid
      - text: Remove custom export job {job_sid} from my account.
        slots:
          job_sid: path.JobSid
      method: generated
      generated: '2026-09-26'