PeerTube · Agentic Access

PeerTube Agentic Access

x-agentic-access generated

PeerTube exposes 324 API operations that an AI agent could call, of which 191 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: 133 read, 167 write, 20 physical, and 4 safety-critical.

4 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.

VideoDecentralizedFederationOpen SourceActivityPubSelf-HostedStreaming
Operations: 324 Acting: 191 Human-in-the-loop: 4 Method: generated

By consequence

read 133 write 167 physical 20 safety-critical 4

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.

MethodPathConsequenceHuman-in-loop
POST /api/v1/users/ask-reset-password safety-critical required
POST /api/v1/users/revoke-token safety-critical required
POST /api/v1/users/{id}/reset-password safety-critical required
POST /api/v1/users/{id}/two-factor/disable safety-critical required
POST /api/v1/server/logs/client physical conditional
POST /api/v1/users/ask-send-verify-email physical conditional
POST /api/v1/users/ask-send-verify-email physical conditional
POST /api/v1/users/registrations/ask-send-verify-email physical conditional
PUT /api/v1/users/{userId}/imports/import-resumable physical conditional
DELETE /api/v1/video-channels/ownership/{id} physical conditional
POST /api/v1/video-channels/ownership/{id}/accept physical conditional
POST /api/v1/video-channels/ownership/{id}/refuse physical conditional
POST /api/v1/video-channels/{channelHandle}/give-ownership physical conditional
POST /api/v1/video-channels/{channelHandle}/video-playlists/reorder physical conditional
POST /api/v1/video-channels/{channelHandle}/video-playlists/reorder physical conditional
POST /api/v1/video-playlists/{playlistId}/videos/reorder physical conditional
DELETE /api/v1/videos/ownership/{id} physical conditional
POST /api/v1/videos/ownership/{id}/accept physical conditional
POST /api/v1/videos/ownership/{id}/refuse physical conditional
PUT /api/v1/videos/upload-resumable physical conditional
PUT /api/v1/videos/upload-resumable physical conditional
PUT /api/v1/videos/{id}/source/replace-resumable physical conditional
PUT /api/v1/videos/{id}/source/replace-resumable physical conditional
POST /api/v1/videos/{videoIdOrUUID}/give-ownership physical conditional

Source

Agentic Access

Raw ↑ 
generated: '2026-09-22'
method: generated
source: openapi/peertube-abuses-api-openapi.yml, openapi/peertube-account-blocklist-api-openapi.yml,
  openapi/peertube-accounts-api-openapi.yml, openapi/peertube-automatic-tags-api-openapi.yml,
  openapi/peertube-channels-sync-api-openapi.yml, openapi/peertube-client-config-api-openapi.yml,
  openapi/peertube-config-api-openapi.yml, openapi/peertube-contact-api-openapi.yml, openapi/peertube-debug-api-openapi.yml,
  openapi/peertube-homepage-api-openapi.yml, openapi/peertube-instance-follows-api-openapi.yml,
  openapi/peertube-instance-redundancy-api-openapi.yml, openapi/peertube-job-api-openapi.yml,
  openapi/peertube-live-videos-api-openapi.yml, openapi/peertube-logs-api-openapi.yml, openapi/peertube-my-history-api-openapi.yml,
  openapi/peertube-my-notifications-api-openapi.yml, openapi/peertube-my-subscriptions-api-openapi.yml,
  openapi/peertube-my-user-api-openapi.yml, openapi/peertube-ownership-change-api-openapi.yml,
  openapi/peertube-player-settings-api-openapi.yml, openapi/peertube-plugins-api-openapi.yml,
  openapi/peertube-register-api-openapi.yml, openapi/peertube-runner-jobs-api-openapi.yml, openapi/peertube-runner-registration-token-api-openapi.yml,
  openapi/peertube-runners-api-openapi.yml, openapi/peertube-search-api-openapi.yml, openapi/peertube-server-blocklist-api-openapi.yml,
  openapi/peertube-session-api-openapi.yml, openapi/peertube-static-video-files-api-openapi.yml,
  openapi/peertube-stats-api-openapi.yml, openapi/peertube-user-exports-api-openapi.yml, openapi/peertube-user-imports-api-openapi.yml,
  openapi/peertube-users-api-openapi.yml, openapi/peertube-video-api-openapi.yml, openapi/peertube-video-blocks-api-openapi.yml,
  openapi/peertube-video-captions-api-openapi.yml, openapi/peertube-video-channels-api-openapi.yml,
  openapi/peertube-video-chapters-api-openapi.yml, openapi/peertube-video-comments-api-openapi.yml,
  openapi/peertube-video-download-api-openapi.yml, openapi/peertube-video-embed-privacy-api-openapi.yml,
  openapi/peertube-video-feeds-api-openapi.yml, openapi/peertube-video-files-api-openapi.yml,
  openapi/peertube-video-imports-api-openapi.yml, openapi/peertube-video-mirroring-api-openapi.yml,
  openapi/peertube-video-passwords-api-openapi.yml, openapi/peertube-video-playlists-api-openapi.yml,
  openapi/peertube-video-rates-api-openapi.yml, openapi/peertube-video-stats-api-openapi.yml,
  openapi/peertube-video-transcoding-api-openapi.yml, openapi/peertube-video-upload-api-openapi.yml,
  openapi/peertube-videos-api-openapi.yml, openapi/peertube-watched-words-api-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: 324
  by_action_class:
    connected: 133
    acting: 191
  by_consequence:
    read: 133
    write: 167
    physical: 20
    safety-critical: 4
  human_in_the_loop_required: 4
operations:
- path: /api/v1/users/me/abuses
  method: get
  operationId: getMyAbuses
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/abuses
  method: get
  operationId: getAbuses
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - admin
    - moderator
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/abuses
  method: post
  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: /api/v1/abuses/{abuseId}
  method: put
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - admin
    - moderator
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/abuses/{abuseId}
  method: delete
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - admin
    - moderator
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/abuses/{abuseId}/messages
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/abuses/{abuseId}/messages
  method: post
  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: /api/v1/abuses/{abuseId}/messages/{abuseMessageId}
  method: delete
  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: /api/v1/blocklist/status
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/users/me/blocklist/accounts
  method: get
  operationId: getMyBlockedAccounts
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/users/me/blocklist/accounts
  method: post
  operationId: blockAccount
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/users/me/blocklist/accounts/{accountName}
  method: delete
  operationId: unblockAccount
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/users/me/blocklist/servers
  method: get
  operationId: getMyBlockedServers
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/users/me/blocklist/servers
  method: post
  operationId: blockServer
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/users/me/blocklist/servers/{host}
  method: delete
  operationId: unblockServer
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/accounts/{name}
  method: get
  operationId: getAccount
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/accounts/{name}/videos
  method: get
  operationId: getAccountVideos
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/accounts/{name}/followers
  method: get
  operationId: getAccountFollowers
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/accounts
  method: get
  operationId: getAccounts
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/accounts/{name}/video-playlists
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/accounts/{name}/video-channels
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/accounts/{name}/video-channel-syncs
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/accounts/{name}/ratings
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/automatic-tags/policies/accounts/{accountName}/comments
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/automatic-tags/policies/accounts/{accountName}/comments
  method: put
  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: /api/v1/automatic-tags/accounts/{accountName}/available
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/automatic-tags/server/available
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - admin
    - moderator
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/video-channels/{channelHandle}/import-videos
  method: post
  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: /api/v1/video-channel-syncs
  method: post
  operationId: addVideoChannelSync
  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: /api/v1/video-channel-syncs/{channelSyncId}
  method: delete
  operationId: delVideoChannelSync
  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: /api/v1/video-channel-syncs/{channelSyncId}/sync
  method: post
  operationId: triggerVideoChannelSync
  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: /api/v1/accounts/{name}/video-channel-syncs
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/client-config/update-language
  method: post
  operationId: updateClientLanguage
  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: /api/v1/client-config/update-interface-language
  method: post
  operationId: updateClientInterfaceLanguage
  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: /api/v1/config
  method: get
  operationId: getConfig
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/config/about
  method: get
  operationId: getAbout
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/config/custom
  method: get
  operationId: getCustomConfig
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - admin
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/config/custom
  method: put
  operationId: putCustomConfig
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - admin
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/config/custom
  method: delete
  operationId: delCustomConfig
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - admin
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/config/instance-banner/pick
  method: post
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - admin
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/config/instance-banner
  method: delete
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - admin
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/config/instance-avatar/pick
  method: post
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - admin
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/config/instance-avatar
  method: delete
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - admin
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/config/instance-logo/{logoType}/pick
  method: post
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - admin
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/config/instance-logo/{logoType}
  method: delete
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - admin
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/server/contact
  method: post
  operationId: contactAdministrator
  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: /api/v1/server/debug
  method: get
  operationId: getDebug
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - admin
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/server/debug/run-command
  method: post
  operationId: runDebugCommand
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - admin
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/custom-pages/homepage/instance
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/custom-pages/homepage/instance
  method: put
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - admin
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/server/followers
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/server/followers/{handle}
  method: delete
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - admin
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/server/followers/{handle}/reject
  method: post
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - admin
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/server/followers/{handle}/accept
  method: post
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - admin
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/server/following
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/server/following
  method: post
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - admin
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/server/following/{hostOrHandle}
  method: delete
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - admin
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/server/redundancy/{host}
  method: put
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - admin
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/jobs/pause
  method: post
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - admin
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/jobs/resume
  method: post
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - admin
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/jobs/{state}
  method: get
  operationId: getJobs
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - admin
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/videos/live
  method: post
  operationId: addLive
  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: /api/v1/videos/live/{id}
  method: get
  operationId: getLiveId
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/videos/live/{id}
  method: put
  operationId: updateLiveId
  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: /api/v1/videos/live/{id}/sessions
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/videos/{id}/live-session
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/server/logs/client
  method: post
  operationId: sendClientLog
  x-agentic-access:
    action-class: acting
    consequence: physical
    subject: required
    audience: null
    token:
      max-ttl: 300
      exchange: true
      purpose-required: true
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/server/logs
  method: get
  operationId: getInstanceLogs
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - admin
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/server/audit-logs
  method: get
  operationId: getInstanceAuditLogs
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - admin
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/users/me/history/videos
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/users/me/history/videos/{videoIdOrUUID}
  method: delete
  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: /api/v1/users/me/history/videos/remove
  method: post
  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: /api/v1/users/me/notifications
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/users/me/notifications/read
  method: post
  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: /api/v1/users/me/notifications/read-all
  method: post
  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: /api/v1/users/me/notification-settings
  method: put
  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: /api/v1/users/me/subscriptions
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/users/me/subscriptions
  method: post
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/users/me/subscriptions/exist
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/users/me/subscriptions/videos
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/users/me/subscriptions/{subscriptionHandle}
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/users/me/subscriptions/{subscriptionHandle}
  method: delete
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/users/me
  method: get
  operationId: getUserInfo
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/users/me
  method: put
  operationId: putUserInfo
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/users/me
  method: delete
  operationId: deleteMe
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/users/me/videos/imports
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/users/me/video-quota-used
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/users/me/videos/{videoIdOrUUID}/rating
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/users/me/videos
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    scope:
    - user
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/users/me/new-feature-info/read
  method: post
  x-agentic-access:
    action-class: acting
    consequence: write
    subject: required
    scope:
    - user
    audience: null
    token:
      max-ttl: 900
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/users/me/avatar/pick
  method: post
  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: /api/v1/users/me/avatar
  method: delete
  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: /api/v1/users/me/abuses
  method: get
  operationId: getMyAbuses
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/videos/ownership
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/videos/ownership/{id}/accept
  method: post
  x-agentic-access:
    action-class: acting
    consequence: physical
    subject: required
    audience: null
    token:
      max-ttl: 300
      exchange: true
      purpose-required: true
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/videos/ownership/{id}/refuse
  method: post
  x-agentic-access:
    action-class: acting
    consequence: physical
    subject: required
    audience: null
    token:
      max-ttl: 300
      exchange: true
      purpose-required: true
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/videos/ownership/{id}
  method: delete
  x-agentic-access:
    action-class: acting
    consequence: physical
    subject: required
    audience: null
    token:
      max-ttl: 300
      exchange: true
      purpose-required: true
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/videos/{videoIdOrUUID}/ownership
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/videos/{videoIdOrUUID}/give-ownership
  method: post
  x-agentic-access:
    action-class: acting
    consequence: physical
    subject: required
    audience: null
    token:
      max-ttl: 300
      exchange: true
      purpose-required: true
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/video-channels/ownership
  method: get
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /api/v1/video-channels/ownership/{id}/accept
  method: post
  x-agentic-access:
    action-class: acting
    consequence: physical
    subject: required
    audience: null
    token:
      max-ttl: 300
      exchange: true
      purpose-required: true
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required
- path: /api/v1/video-channels/ownership/{id}/refuse
  method: post
  x-agentic-access:
    action-class: acting
    consequence: physical
    subject: required
    audience: null
    token:
      max-ttl: 300
      exchange: true
      purpose-required: true
    escalation:
      human-in-the-loop: conditional
      triggers:
      - abnormal
      - high-value
    audit: required


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

Work with this as data

Every access contract here is available over the APIs.io API and to AI agents over MCP. Agentic Access is not yet its own endpoint on the v1 API. Reach it through catalog search and the tag graph, or the MCP server.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for agentic access

3 MCP tools reach this
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
Search the catalog 
curl "https://apis.io/api/v1/search?q=peertube-agentic-access&limit=10"
Everything under a tag 
curl "https://apis.io/api/v1/tags/peertube-agentic-access"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.