Mux · Agentic Access
Mux Agentic Access

x-agentic-access generated
Mux exposes 124 API operations that an AI agent could call, of which 52 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: 72 read, 50 write, 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.
Video InfrastructureVideo StreamingLive StreamingVideo AnalyticsVideo AIEncoding
Operations: 124 Acting: 52 Human-in-the-loop: 2 Method: generated
By consequence

read 72 write 50 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
PUT	/video/v1/live-streams/{LIVE_STREAM_ID}/disable	safety-critical	required
POST	/video/v1/live-streams/{LIVE_STREAM_ID}/reset-stream-key	safety-critical	required
Source

Agentic Access

generated: '2026-07-15'
method: generated
source: openapi/mux-openapi.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: 124
  by_action_class:
    acting: 52
    connected: 72
  by_consequence:
    write: 50
    read: 72
    safety-critical: 2
  human_in_the_loop_required: 2
operations:
- path: /video/v1/transcription-vocabularies
  method: post
  operationId: create-transcription-vocabulary
  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: /video/v1/transcription-vocabularies
  method: get
  operationId: list-transcription-vocabularies
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /video/v1/transcription-vocabularies/{TRANSCRIPTION_VOCABULARY_ID}
  method: get
  operationId: get-transcription-vocabulary
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /video/v1/transcription-vocabularies/{TRANSCRIPTION_VOCABULARY_ID}
  method: delete
  operationId: delete-transcription-vocabulary
  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: /video/v1/transcription-vocabularies/{TRANSCRIPTION_VOCABULARY_ID}
  method: put
  operationId: update-transcription-vocabulary
  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: /video/v1/assets
  method: post
  operationId: create-asset
  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: /video/v1/assets
  method: get
  operationId: list-assets
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /video/v1/assets/{ASSET_ID}
  method: get
  operationId: get-asset
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /video/v1/assets/{ASSET_ID}
  method: delete
  operationId: delete-asset
  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: /video/v1/assets/{ASSET_ID}
  method: patch
  operationId: update-asset
  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: /video/v1/assets/{ASSET_ID}/input-info
  method: get
  operationId: get-asset-input-info
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /video/v1/assets/{ASSET_ID}/playback-ids
  method: post
  operationId: create-asset-playback-id
  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: /video/v1/assets/{ASSET_ID}/playback-ids/{PLAYBACK_ID}
  method: get
  operationId: get-asset-playback-id
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /video/v1/assets/{ASSET_ID}/playback-ids/{PLAYBACK_ID}
  method: delete
  operationId: delete-asset-playback-id
  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: /video/v1/assets/{ASSET_ID}/mp4-support
  method: put
  operationId: update-asset-mp4-support
  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: /video/v1/assets/{ASSET_ID}/master-access
  method: put
  operationId: update-asset-master-access
  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: /video/v1/assets/{ASSET_ID}/static-renditions
  method: post
  operationId: create-asset-static-rendition
  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: /video/v1/assets/{ASSET_ID}/static-renditions/{STATIC_RENDITION_ID}
  method: delete
  operationId: delete-asset-static-rendition
  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: /video/v1/assets/{ASSET_ID}/tracks
  method: post
  operationId: create-asset-track
  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: /video/v1/assets/{ASSET_ID}/tracks/{TRACK_ID}
  method: delete
  operationId: delete-asset-track
  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: /video/v1/assets/{ASSET_ID}/tracks/{TRACK_ID}
  method: patch
  operationId: update-asset-track
  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: /video/v1/assets/{ASSET_ID}/tracks/{TRACK_ID}/generate-subtitles
  method: post
  operationId: generate-asset-track-subtitles
  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: /video/v1/live-streams
  method: post
  operationId: create-live-stream
  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: /video/v1/live-streams
  method: get
  operationId: list-live-streams
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /video/v1/live-streams/{LIVE_STREAM_ID}
  method: get
  operationId: get-live-stream
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /video/v1/live-streams/{LIVE_STREAM_ID}
  method: delete
  operationId: delete-live-stream
  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: /video/v1/live-streams/{LIVE_STREAM_ID}
  method: patch
  operationId: update-live-stream
  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: /video/v1/live-streams/{LIVE_STREAM_ID}/playback-ids
  method: post
  operationId: create-live-stream-playback-id
  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: /video/v1/live-streams/{LIVE_STREAM_ID}/playback-ids/{PLAYBACK_ID}
  method: get
  operationId: get-live-stream-playback-id
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /video/v1/live-streams/{LIVE_STREAM_ID}/playback-ids/{PLAYBACK_ID}
  method: delete
  operationId: delete-live-stream-playback-id
  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: /video/v1/live-streams/{LIVE_STREAM_ID}/reset-stream-key
  method: post
  operationId: reset-stream-key
  x-agentic-access:
    action-class: acting
    consequence: safety-critical
    subject: required
    audience: null
    token:
      max-ttl: 120
      exchange: true
      purpose-required: true
      proof-of-possession: true
    escalation:
      human-in-the-loop: required
    audit: required
- path: /video/v1/live-streams/{LIVE_STREAM_ID}/complete
  method: put
  operationId: signal-live-stream-complete
  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: /video/v1/live-streams/{LIVE_STREAM_ID}/disable
  method: put
  operationId: disable-live-stream
  x-agentic-access:
    action-class: acting
    consequence: safety-critical
    subject: required
    audience: null
    token:
      max-ttl: 120
      exchange: true
      purpose-required: true
      proof-of-possession: true
    escalation:
      human-in-the-loop: required
    audit: required
- path: /video/v1/live-streams/{LIVE_STREAM_ID}/enable
  method: put
  operationId: enable-live-stream
  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: /video/v1/live-streams/{LIVE_STREAM_ID}/embedded-subtitles
  method: put
  operationId: update-live-stream-embedded-subtitles
  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: /video/v1/live-streams/{LIVE_STREAM_ID}/generated-subtitles
  method: put
  operationId: update-live-stream-generated-subtitles
  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: /video/v1/playback-ids/{PLAYBACK_ID}
  method: get
  operationId: get-asset-or-livestream-id
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /video/v1/live-streams/{LIVE_STREAM_ID}/simulcast-targets
  method: post
  operationId: create-live-stream-simulcast-target
  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: /video/v1/live-streams/{LIVE_STREAM_ID}/simulcast-targets/{SIMULCAST_TARGET_ID}
  method: delete
  operationId: delete-live-stream-simulcast-target
  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: /video/v1/live-streams/{LIVE_STREAM_ID}/simulcast-targets/{SIMULCAST_TARGET_ID}
  method: get
  operationId: get-live-stream-simulcast-target
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /video/v1/live-streams/{LIVE_STREAM_ID}/new-asset-settings/static-renditions
  method: put
  operationId: update-live-stream-new-asset-settings-static-renditions
  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: /video/v1/live-streams/{LIVE_STREAM_ID}/new-asset-settings/static-renditions
  method: delete
  operationId: delete-live-stream-new-asset-settings-static-renditions
  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: /video/v1/signing-keys
  method: post
  operationId: create-url-signing-key
  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: /video/v1/signing-keys
  method: get
  operationId: list-url-signing-keys
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /video/v1/signing-keys/{SIGNING_KEY_ID}
  method: get
  operationId: get-url-signing-key
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /video/v1/signing-keys/{SIGNING_KEY_ID}
  method: delete
  operationId: delete-url-signing-key
  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: /video/v1/uploads
  method: post
  operationId: create-direct-upload
  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: /video/v1/uploads
  method: get
  operationId: list-direct-uploads
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /video/v1/uploads/{UPLOAD_ID}
  method: get
  operationId: get-direct-upload
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /video/v1/uploads/{UPLOAD_ID}/cancel
  method: put
  operationId: cancel-direct-upload
  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: /video/v1/delivery-usage
  method: get
  operationId: list-delivery-usage
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /video/v1/playback-restrictions
  method: post
  operationId: create-playback-restriction
  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: /video/v1/playback-restrictions
  method: get
  operationId: list-playback-restrictions
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /video/v1/playback-restrictions/{PLAYBACK_RESTRICTION_ID}
  method: delete
  operationId: delete-playback-restriction
  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: /video/v1/playback-restrictions/{PLAYBACK_RESTRICTION_ID}
  method: get
  operationId: get-playback-restriction
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /video/v1/playback-restrictions/{PLAYBACK_RESTRICTION_ID}/referrer
  method: put
  operationId: update-referrer-domain-restriction
  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: /video/v1/playback-restrictions/{PLAYBACK_RESTRICTION_ID}/user_agent
  method: put
  operationId: update-user-agent-restriction
  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: /video/v1/drm-configurations
  method: get
  operationId: list-drm-configurations
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /video/v1/drm-configurations/{DRM_CONFIGURATION_ID}
  method: get
  operationId: get-drm-configuration
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/video-views
  method: get
  operationId: list-video-views
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/video-views/{VIDEO_VIEW_ID}
  method: get
  operationId: get-video-view
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/errors
  method: get
  operationId: list-errors
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/filters
  method: get
  operationId: list-filters
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/filters/{FILTER_ID}
  method: get
  operationId: list-filter-values
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/dimensions
  method: get
  operationId: list-dimensions
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/dimensions/{DIMENSION_ID}
  method: get
  operationId: list-dimension-values
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/dimensions/{DIMENSION_ID}/elements
  method: get
  operationId: list-dimension-elements
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/exports
  method: get
  operationId: list-exports
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/exports/views
  method: get
  operationId: list-exports-views
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/metrics/{METRIC_ID}/breakdown
  method: get
  operationId: list-breakdown-values
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/metrics/{METRIC_ID}/overall
  method: get
  operationId: get-overall-values
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/metrics/{METRIC_ID}/insights
  method: get
  operationId: list-insights
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/metrics/{METRIC_ID}/timeseries
  method: get
  operationId: get-metric-timeseries-data
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/metrics/comparison
  method: get
  operationId: list-all-metric-values
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/monitoring/dimensions
  method: get
  operationId: list-monitoring-dimensions
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/monitoring/metrics
  method: get
  operationId: list-monitoring-metrics
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/monitoring/metrics/{MONITORING_METRIC_ID}/breakdown
  method: get
  operationId: get-monitoring-breakdown
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/monitoring/metrics/{MONITORING_METRIC_ID}/breakdown-timeseries
  method: get
  operationId: get-monitoring-breakdown-timeseries
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/monitoring/metrics/{MONITORING_HISTOGRAM_METRIC_ID}/histogram-timeseries
  method: get
  operationId: get-monitoring-histogram-timeseries
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/monitoring/metrics/{MONITORING_METRIC_ID}/timeseries
  method: get
  operationId: get-monitoring-timeseries
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/realtime/dimensions
  method: get
  operationId: list-realtime-dimensions
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/realtime/metrics
  method: get
  operationId: list-realtime-metrics
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/realtime/metrics/{REALTIME_METRIC_ID}/breakdown
  method: get
  operationId: get-realtime-breakdown
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/realtime/metrics/{REALTIME_HISTOGRAM_METRIC_ID}/histogram-timeseries
  method: get
  operationId: get-realtime-histogram-timeseries
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/realtime/metrics/{REALTIME_METRIC_ID}/timeseries
  method: get
  operationId: get-realtime-timeseries
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/incidents
  method: get
  operationId: list-incidents
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/incidents/{INCIDENT_ID}
  method: get
  operationId: get-incident
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/incidents/{INCIDENT_ID}/related
  method: get
  operationId: list-related-incidents
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/annotations
  method: get
  operationId: list-annotations
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/annotations
  method: post
  operationId: create-annotation
  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: /data/v1/annotations/{ANNOTATION_ID}
  method: get
  operationId: get-annotation
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /data/v1/annotations/{ANNOTATION_ID}
  method: patch
  operationId: update-annotation
  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: /data/v1/annotations/{ANNOTATION_ID}
  method: delete
  operationId: delete-annotation
  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: /system/v1/whoami
  method: get
  operationId: get-whoami
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /system/v1/signing-keys
  method: post
  operationId: create-signing-key
  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: /system/v1/signing-keys
  method: get
  operationId: list-signing-keys
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /system/v1/signing-keys/{SIGNING_KEY_ID}
  method: get
  operationId: get-signing-key
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /system/v1/signing-keys/{SIGNING_KEY_ID}
  method: delete
  operationId: delete-signing-key
  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: /robots/v0/jobs
  method: get
  operationId: list-jobs
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /robots/v0/jobs/{JOB_ID}/cancel
  method: post
  operationId: cancel-job
  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: /robots/v0/jobs/ask-questions
  method: post
  operationId: create-ask-questions-job
  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: /robots/v0/jobs/ask-questions/{JOB_ID}
  method: get
  operationId: get-ask-questions-job
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /robots/v0/jobs/edit-captions
  method: post
  operationId: create-edit-captions-job
  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: /robots/v0/jobs/edit-captions/{JOB_ID}
  method: get
  operationId: get-edit-captions-job
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /robots/v0/jobs/find-key-moments
  method: post
  operationId: create-find-key-moments-job
  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: /robots/v0/jobs/find-key-moments/{JOB_ID}
  method: get
  operationId: get-find-key-moments-job
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /robots/v0/jobs/generate-chapters
  method: post
  operationId: create-generate-chapters-job
  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: /robots/v0/jobs/generate-chapters/{JOB_ID}
  method: get
  operationId: get-generate-chapters-job
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
 

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