generated: '2026-07-15'
method: generated
source: openapi/chess-com-published-data-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: 29
  by_action_class:
    connected: 29
  by_consequence:
    read: 29
  human_in_the_loop_required: 0
operations:
- path: /player/{username}
  method: get
  operationId: getPlayerProfile
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /player/{username}/stats
  method: get
  operationId: getPlayerStats
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /player/{username}/is-online
  method: get
  operationId: getPlayerOnline
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /player/{username}/games
  method: get
  operationId: getPlayerCurrentGames
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /player/{username}/games/to-move
  method: get
  operationId: getPlayerGamesToMove
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /player/{username}/games/archives
  method: get
  operationId: listPlayerArchives
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /player/{username}/games/{year}/{month}
  method: get
  operationId: getPlayerMonthlyArchive
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /player/{username}/games/{year}/{month}/pgn
  method: get
  operationId: getPlayerMonthlyArchivePgn
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /player/{username}/clubs
  method: get
  operationId: getPlayerClubs
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /player/{username}/matches
  method: get
  operationId: getPlayerMatches
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /player/{username}/tournaments
  method: get
  operationId: getPlayerTournaments
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /titled/{title-abbrev}
  method: get
  operationId: listTitledPlayers
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /club/{url-ID}
  method: get
  operationId: getClub
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /club/{url-ID}/members
  method: get
  operationId: getClubMembers
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /club/{url-ID}/matches
  method: get
  operationId: getClubMatches
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /tournament/{url-ID}
  method: get
  operationId: getTournament
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /tournament/{url-ID}/{round}
  method: get
  operationId: getTournamentRound
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /tournament/{url-ID}/{round}/{group}
  method: get
  operationId: getTournamentRoundGroup
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /match/{ID}
  method: get
  operationId: getDailyMatch
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /match/{ID}/{board}
  method: get
  operationId: getDailyMatchBoard
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /match/live/{ID}
  method: get
  operationId: getLiveMatch
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /match/live/{ID}/{board}
  method: get
  operationId: getLiveMatchBoard
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /country/{iso}
  method: get
  operationId: getCountry
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /country/{iso}/players
  method: get
  operationId: listCountryPlayers
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /country/{iso}/clubs
  method: get
  operationId: listCountryClubs
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /puzzle
  method: get
  operationId: getDailyPuzzle
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /puzzle/random
  method: get
  operationId: getRandomPuzzle
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /streamers
  method: get
  operationId: listStreamers
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none
- path: /leaderboards
  method: get
  operationId: getLeaderboards
  x-agentic-access:
    action-class: connected
    consequence: read
    subject: optional
    token:
      max-ttl: 3600
    audit: none