generated: '2026-07-15'
method: generated
source: openapi/chartmetric-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: 26
  by_action_class:
    acting: 1
    connected: 25
  by_consequence:
    write: 1
    read: 25
  human_in_the_loop_required: 0
operations:
- path: /token
  method: post
  operationId: createToken
  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: /search
  method: get
  operationId: search
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /artist/{id}
  method: get
  operationId: getArtist
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /artist/{id}/stat/{source}
  method: get
  operationId: getArtistStat
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /artist/{id}/urls
  method: get
  operationId: getArtistUrls
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /artist/{id}/relatedartists
  method: get
  operationId: getRelatedArtists
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /artist/{id}/where-people-listen
  method: get
  operationId: getArtistWherePeopleListen
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /artist/{id}/tracks
  method: get
  operationId: getArtistTracks
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /artist/{id}/albums
  method: get
  operationId: getArtistAlbums
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /artist/{id}/{source}/{status}/playlists
  method: get
  operationId: getArtistPlaylists
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /track/{id}
  method: get
  operationId: getTrack
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /track/{id}/{platform}/stats
  method: get
  operationId: getTrackStats
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /track/{id}/{chartType}/charts
  method: get
  operationId: getTrackCharts
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /track/{id}/{platform}/{status}/playlists
  method: get
  operationId: getTrackPlaylists
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /album/{id}
  method: get
  operationId: getAlbum
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /album/{id}/tracks
  method: get
  operationId: getAlbumTracks
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /album/{id}/{source}/followers
  method: get
  operationId: getAlbumFollowers
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /album/{id}/{source}/{status}/playlists
  method: get
  operationId: getAlbumPlaylists
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /playlist/{platform}/{id}
  method: get
  operationId: getPlaylist
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /playlist/{platform}/{id}/{span}/tracks
  method: get
  operationId: getPlaylistTracks
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /playlist/{platform}/{id}/snapshot
  method: get
  operationId: getPlaylistSnapshot
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /playlist/{platform}/lists
  method: get
  operationId: getPlaylistLists
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /charts/{platform}
  method: get
  operationId: getCharts
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /charts/artist/{id}/{chartType}/cm-score
  method: get
  operationId: getArtistCmScore
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /charts/track/{id}/{chartType}/cm-score
  method: get
  operationId: getTrackCmScore
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /charts/album/{id}/{chartType}/cm-score
  method: get
  operationId: getAlbumCmScore
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none