Twilio · Agentic Access
Twilio Agentic Access

x-agentic-access generated
Twilio exposes 1106 API operations that an AI agent could call, of which 546 are state-changing ‘acting’ operations. This is a recommended x-agentic-access execution contract — the scope, audience, consequence tier, short-lived token constraints, and escalation each action should carry before it is handed to an autonomous agent.
By consequence: 560 read, 535 write, 9 physical, and 2 safety-critical.
2 operations are classed safety-critical and should require human-in-the-loop approval at runtime.
Contracts are classified heuristically from the provider’s OpenAPI and refresh on every APIs.io network build; audience is bound per deployment. The model follows Curity’s Access Intelligence (apidays Munich 2026). Browse every provider’s agent contracts at agentic-access.apis.io.
AuthenticationCommunicationsContact CenterEmailIoTMessagingPhoneSMST1VerificationVideoVoice
Operations: 1106 Acting: 546 Human-in-the-loop: 2 Method: generated
By consequence

read 560 write 535 physical 9 safety-critical 2
Highest-consequence actions

The physical and safety-critical operations an agent could invoke — the ones that most warrant scoped tokens, tight TTLs, and escalation. Full per-operation contracts are in the source below.
Method	Path	Consequence	Human-in-loop
POST	/v1/Trunks/{TrunkSid}/IpAccessControlLists	safety-critical	required
DELETE	/v1/Trunks/{TrunkSid}/IpAccessControlLists/{Sid}	safety-critical	required
POST	/Accounts/{AccountSid}/Messages.json	physical	conditional
POST	/Services/{ServiceSid}/AlphaSenders	physical	conditional
POST	/mail/send	physical	conditional
POST	/v1/Services/{ServiceSid}/AlphaSenders	physical	conditional
DELETE	/v1/Services/{ServiceSid}/AlphaSenders/{Sid}	physical	conditional
POST	/v1/Services/{ServiceSid}/Environments/{EnvironmentSid}/Deployments	physical	conditional
POST	/v2/HostedNumber/Orders	physical	conditional
DELETE	/v2/HostedNumber/Orders/{Sid}	physical	conditional
POST	/verified_senders	physical	conditional
Source

Agentic Access

generated: '2026-07-15'
method: generated
source: openapi/accounts-openapi-original.yml, openapi/assistant-openapi-original.yml, openapi/autopilot-openapi-original.yml,
  openapi/bulk-exports-openapi-original.yml, openapi/content-openapi-original.yml, openapi/conversations-openapi-original.yml,
  openapi/events-openapi-original.yml, openapi/frontline-openapi-original.yml, openapi/insights-openapi-original.yml,
  openapi/intelligence-openapi-original.yml, openapi/ip-message-openapi-original.yml, openapi/marketplace-openapi-original.yml,
  openapi/media-openapi-original.yml, openapi/messaging-openapi-original.yml, openapi/microvisor-openapi-original.yml,
  openapi/monitor-openapi-original.yml, openapi/notify-openapi-original.yml, openapi/numbers-openapi-original.yml,
  openapi/pricing-openapi-original.yml, openapi/proxy-openapi-original.yml, openapi/routes-openapi-original.yml,
  openapi/serverless-openapi-original.yml, openapi/studio-openapi-original.yml, openapi/super-sim-openapi-original.yml,
  openapi/sync-openapi-original.yml, openapi/task-router-openapi-original.yml, openapi/trunking-openapi-original.yml,
  openapi/trust-hub-openapi-original.yml, openapi/twilio-accounts-openapi.yml, openapi/twilio-flex-openapi.yml,
  openapi/twilio-lookup-openapi.yml, openapi/twilio-messaging-openapi.yml, openapi/twilio-sendgrid-openapi.yml,
  openapi/twilio-verify-openapi.yml, openapi/twilio-video-openapi.yml, openapi/twilio-voice-openapi.yml,
  openapi/verify-openapi-original.yml, openapi/video-openapi-original.yml, openapi/voice-openapi-original.yml,
  openapi/wireless-openapi-original.yml
description: Recommended x-agentic-access execution contracts, classified heuristically from
  the OpenAPI. A governance starting point for exposing this API to AI agents — review and bind
  audience per deployment. See research/curity/agentic-governance/.
summary:
  operations: 1106
  by_action_class:
    acting: 546
    connected: 560
  by_consequence:
    write: 535
    read: 560
    physical: 9
    safety-critical: 2
  human_in_the_loop_required: 2
operations:
- path: /v1/AuthTokens/Promote
  method: post
  operationId: UpdateAuthTokenPromotion
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Credentials/AWS
  method: get
  operationId: ListCredentialAws
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/Credentials/AWS
  method: post
  operationId: CreateCredentialAws
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Credentials/AWS/{Sid}
  method: get
  operationId: FetchCredentialAws
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/Credentials/AWS/{Sid}
  method: post
  operationId: UpdateCredentialAws
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Credentials/AWS/{Sid}
  method: delete
  operationId: DeleteCredentialAws
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Credentials/PublicKeys
  method: get
  operationId: ListCredentialPublicKey
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/Credentials/PublicKeys
  method: post
  operationId: CreateCredentialPublicKey
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Credentials/PublicKeys/{Sid}
  method: get
  operationId: FetchCredentialPublicKey
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/Credentials/PublicKeys/{Sid}
  method: post
  operationId: UpdateCredentialPublicKey
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Credentials/PublicKeys/{Sid}
  method: delete
  operationId: DeleteCredentialPublicKey
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/SafeList/Numbers
  method: post
  operationId: CreateSafelist
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/SafeList/Numbers
  method: get
  operationId: FetchSafelist
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/SafeList/Numbers
  method: delete
  operationId: DeleteSafelist
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/AuthTokens/Secondary
  method: post
  operationId: CreateSecondaryAuthToken
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/AuthTokens/Secondary
  method: delete
  operationId: DeleteSecondaryAuthToken
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{Sid}
  method: get
  operationId: FetchUnderstandAssistant
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /understand/Assistants/{Sid}
  method: post
  operationId: UpdateUnderstandAssistant
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{Sid}
  method: delete
  operationId: DeleteUnderstandAssistant
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/FallbackActions
  method: get
  operationId: FetchUnderstandAssistantFallbackActions
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /understand/Assistants/{AssistantSid}/FallbackActions
  method: post
  operationId: UpdateUnderstandAssistantFallbackActions
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/InitiationActions
  method: get
  operationId: FetchUnderstandAssistantInitiationActions
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /understand/Assistants/{AssistantSid}/InitiationActions
  method: post
  operationId: UpdateUnderstandAssistantInitiationActions
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/Dialogues/{Sid}
  method: get
  operationId: FetchUnderstandDialogue
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Fields/{Sid}
  method: get
  operationId: FetchUnderstandField
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Fields/{Sid}
  method: delete
  operationId: DeleteUnderstandField
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Fields
  method: get
  operationId: ListUnderstandField
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Fields
  method: post
  operationId: CreateUnderstandField
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/FieldTypes/{Sid}
  method: get
  operationId: FetchUnderstandFieldType
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /understand/Assistants/{AssistantSid}/FieldTypes/{Sid}
  method: post
  operationId: UpdateUnderstandFieldType
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/FieldTypes/{Sid}
  method: delete
  operationId: DeleteUnderstandFieldType
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/FieldTypes
  method: get
  operationId: ListUnderstandFieldType
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /understand/Assistants/{AssistantSid}/FieldTypes
  method: post
  operationId: CreateUnderstandFieldType
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/FieldTypes/{FieldTypeSid}/FieldValues/{Sid}
  method: get
  operationId: FetchUnderstandFieldValue
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /understand/Assistants/{AssistantSid}/FieldTypes/{FieldTypeSid}/FieldValues/{Sid}
  method: delete
  operationId: DeleteUnderstandFieldValue
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/FieldTypes/{FieldTypeSid}/FieldValues
  method: get
  operationId: ListUnderstandFieldValue
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /understand/Assistants/{AssistantSid}/FieldTypes/{FieldTypeSid}/FieldValues
  method: post
  operationId: CreateUnderstandFieldValue
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/ModelBuilds/{Sid}
  method: get
  operationId: FetchUnderstandModelBuild
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /understand/Assistants/{AssistantSid}/ModelBuilds/{Sid}
  method: post
  operationId: UpdateUnderstandModelBuild
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/ModelBuilds/{Sid}
  method: delete
  operationId: DeleteUnderstandModelBuild
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/ModelBuilds
  method: get
  operationId: ListUnderstandModelBuild
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /understand/Assistants/{AssistantSid}/ModelBuilds
  method: post
  operationId: CreateUnderstandModelBuild
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/Queries/{Sid}
  method: get
  operationId: FetchUnderstandQuery
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /understand/Assistants/{AssistantSid}/Queries/{Sid}
  method: post
  operationId: UpdateUnderstandQuery
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/Queries/{Sid}
  method: delete
  operationId: DeleteUnderstandQuery
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/Queries
  method: get
  operationId: ListUnderstandQuery
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /understand/Assistants/{AssistantSid}/Queries
  method: post
  operationId: CreateUnderstandQuery
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Samples/{Sid}
  method: get
  operationId: FetchUnderstandSample
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Samples/{Sid}
  method: post
  operationId: UpdateUnderstandSample
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Samples/{Sid}
  method: delete
  operationId: DeleteUnderstandSample
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Samples
  method: get
  operationId: ListUnderstandSample
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Samples
  method: post
  operationId: CreateUnderstandSample
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/StyleSheet
  method: get
  operationId: FetchUnderstandStyleSheet
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /understand/Assistants/{AssistantSid}/StyleSheet
  method: post
  operationId: UpdateUnderstandStyleSheet
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/Tasks/{Sid}
  method: get
  operationId: FetchUnderstandTask
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /understand/Assistants/{AssistantSid}/Tasks/{Sid}
  method: post
  operationId: UpdateUnderstandTask
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/Tasks/{Sid}
  method: delete
  operationId: DeleteUnderstandTask
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/Tasks
  method: get
  operationId: ListUnderstandTask
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /understand/Assistants/{AssistantSid}/Tasks
  method: post
  operationId: CreateUnderstandTask
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Actions
  method: get
  operationId: FetchUnderstandTaskActions
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Actions
  method: post
  operationId: UpdateUnderstandTaskActions
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /understand/Assistants/{AssistantSid}/Tasks/{TaskSid}/Statistics
  method: get
  operationId: FetchUnderstandTaskStatistics
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/Assistants/{Sid}
  method: get
  operationId: FetchAssistant
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/Assistants/{Sid}
  method: post
  operationId: UpdateAssistant
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Assistants/{Sid}
  method: delete
  operationId: DeleteAssistant
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Assistants
  method: get
  operationId: ListAssistant
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/Assistants
  method: post
  operationId: CreateAssistant
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Assistants/{AssistantSid}/Defaults
  method: get
  operationId: FetchDefaults
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/Assistants/{AssistantSid}/Defaults
  method: post
  operationId: UpdateDefaults
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Assistants/{AssistantSid}/Dialogues/{Sid}
  method: get
  operationId: FetchDialogue
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/Assistants/{AssistantSid}/Tasks/{TaskSid}/Fields/{Sid}
  method: get
  operationId: FetchField
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/Assistants/{AssistantSid}/Tasks/{TaskSid}/Fields/{Sid}
  method: delete
  operationId: DeleteField
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Assistants/{AssistantSid}/Tasks/{TaskSid}/Fields
  method: get
  operationId: ListField
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/Assistants/{AssistantSid}/Tasks/{TaskSid}/Fields
  method: post
  operationId: CreateField
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Assistants/{AssistantSid}/FieldTypes/{Sid}
  method: get
  operationId: FetchFieldType
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/Assistants/{AssistantSid}/FieldTypes/{Sid}
  method: post
  operationId: UpdateFieldType
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Assistants/{AssistantSid}/FieldTypes/{Sid}
  method: delete
  operationId: DeleteFieldType
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Assistants/{AssistantSid}/FieldTypes
  method: get
  operationId: ListFieldType
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/Assistants/{AssistantSid}/FieldTypes
  method: post
  operationId: CreateFieldType
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Assistants/{AssistantSid}/FieldTypes/{FieldTypeSid}/FieldValues/{Sid}
  method: get
  operationId: FetchFieldValue
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/Assistants/{AssistantSid}/FieldTypes/{FieldTypeSid}/FieldValues/{Sid}
  method: delete
  operationId: DeleteFieldValue
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Assistants/{AssistantSid}/FieldTypes/{FieldTypeSid}/FieldValues
  method: get
  operationId: ListFieldValue
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/Assistants/{AssistantSid}/FieldTypes/{FieldTypeSid}/FieldValues
  method: post
  operationId: CreateFieldValue
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Assistants/{AssistantSid}/ModelBuilds/{Sid}
  method: get
  operationId: FetchModelBuild
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/Assistants/{AssistantSid}/ModelBuilds/{Sid}
  method: post
  operationId: UpdateModelBuild
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Assistants/{AssistantSid}/ModelBuilds/{Sid}
  method: delete
  operationId: DeleteModelBuild
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Assistants/{AssistantSid}/ModelBuilds
  method: get
  operationId: ListModelBuild
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/Assistants/{AssistantSid}/ModelBuilds
  method: post
  operationId: CreateModelBuild
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Assistants/{AssistantSid}/Queries/{Sid}
  method: get
  operationId: FetchQuery
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/Assistants/{AssistantSid}/Queries/{Sid}
  method: post
  operationId: UpdateQuery
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Assistants/{AssistantSid}/Queries/{Sid}
  method: delete
  operationId: DeleteQuery
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Assistants/{AssistantSid}/Queries
  method: get
  operationId: ListQuery
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/Assistants/{AssistantSid}/Queries
  method: post
  operationId: CreateQuery
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Assistants/Restore
  method: post
  operationId: UpdateRestoreAssistant
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Assistants/{AssistantSid}/Tasks/{TaskSid}/Samples/{Sid}
  method: get
  operationId: FetchSample
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /v1/Assistants/{AssistantSid}/Tasks/{TaskSid}/Samples/{Sid}
  method: post
  operationId: UpdateSample
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /v1/Assistants/{AssistantSid}/Tasks/{TaskSid}/Samples/{Sid}
  method: delete
  operationId: DeleteSample
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      trigge

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