# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for JFrog Platform REST Access Tokens API
  version: 1.0.0
extends: openapi/jfrog-access-tokens-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/access/api/v2/tokens'].get
  update:
    x-apievangelist-phrasing:
      intent: List access tokens
      effect: read
      questions:
      - Which access tokens have been issued on my platform?
      - Can I see all existing access tokens to audit them?
      instructions:
      - text: List all access tokens.
      - text: Show me every access token that has been issued.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/access/api/v2/tokens'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an access token
      effect: write
      questions:
      - How do I generate a scoped access token for a CI job?
      - Can I make an access token that expires and can be refreshed?
      instructions:
      - text: Create an access token with scope {scope}.
        slots:
          scope: requestBody.scope
      - text: Create a token for {subject} with scope {scope} expiring in {expires_in} seconds.
        slots:
          subject: requestBody.subject
          scope: requestBody.scope
          expires_in: requestBody.expires_in
      method: generated
      generated: '2026-10-01'
- target: $.paths['/access/api/v2/tokens/{tokenId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get access token details
      effect: read
      questions:
      - What scope and expiry does a particular token have?
      - Can I look up one access token by its ID?
      instructions:
      - text: Get details for token {tokenId}.
        slots:
          tokenId: path.tokenId
      - text: Show me the scope and expiry of access token {tokenId}.
        slots:
          tokenId: path.tokenId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/access/api/v2/tokens/{tokenId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Revoke an access token
      effect: destructive
      questions:
      - How do I revoke a leaked access token?
      - Can I invalidate one token without affecting others?
      instructions:
      - text: Revoke access token {tokenId}.
        slots:
          tokenId: path.tokenId
      - text: Invalidate the token with ID {tokenId} right away.
        slots:
          tokenId: path.tokenId
      method: generated
      generated: '2026-10-01'