# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Trello Tokens API
  version: 1.0.0
extends: openapi/trello-tokens-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 9
- target: $.paths['/tokens/{token}'].get
  update:
    x-apievangelist-phrasing:
      intent: Inspect an API token
      effect: read
      questions:
      - How do I check what permissions and expiry an API token has?
      - Can I see a token's details along with its webhooks?
      instructions:
      - text: Show me the details of token {token}.
        slots:
          token: path.token
      - text: Inspect token {token} and include its webhooks ({webhooks}).
        slots:
          token: path.token
          webhooks: query.webhooks
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tokens/{token}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Revoke an API token and its webhooks
      effect: destructive
      questions:
      - How do I revoke a Trello API token?
      - What happens to the webhooks a token created when I revoke it?
      instructions:
      - text: Revoke token {token} and remove its webhooks.
        slots:
          token: path.token
      - text: Kill access for API token {token}.
        slots:
          token: path.token
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tokens/{token}/webhooks'].get
  update:
    x-apievangelist-phrasing:
      intent: List webhooks created by a token
      effect: read
      questions:
      - Which webhooks has my token registered?
      - How do I audit all callbacks set up under one token?
      instructions:
      - text: List the webhooks for token {token}.
        slots:
          token: path.token
      - text: Show every callback registered under token {token}.
        slots:
          token: path.token
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tokens/{token}/webhooks'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a webhook under a token
      effect: write
      questions:
      - How do I get notified when a board or card changes?
      - Why does my webhook creation fail if my callback URL doesn't answer a HEAD request?
      instructions:
      - text: Create a webhook for token {token} watching {idModel} that calls {callbackURL}.
        slots:
          token: path.token
          idModel: query.idModel
          callbackURL: query.callbackURL
      - text: Register {callbackURL} to receive changes on model {idModel} under token {token}, described as {description}.
        slots:
          callbackURL: query.callbackURL
          idModel: query.idModel
          token: path.token
          description: query.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tokens/{token}/member'].get
  update:
    x-apievangelist-phrasing:
      intent: Find who owns a token
      effect: read
      questions:
      - Which member does an API token belong to?
      - How do I look up the owner of a token?
      instructions:
      - text: Get the member who owns token {token}.
        slots:
          token: path.token
      - text: Tell me whose account token {token} is for.
        slots:
          token: path.token
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tokens/{token}/webhooks/{idWebhook}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one webhook created by a token
      effect: read
      questions:
      - How do I see the callback URL and model for one of my token's webhooks?
      - Can I look up a single webhook by id under a token?
      instructions:
      - text: Show webhook {idWebhook} under token {token}.
        slots:
          idWebhook: path.idWebhook
          token: path.token
      - text: Get the settings of token {token}'s webhook {idWebhook}.
        slots:
          token: path.token
          idWebhook: path.idWebhook
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tokens/{token}/webhooks/{idWebhook}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a webhook created by a token
      effect: write
      questions:
      - How do I point an existing webhook at a new callback URL?
      - Can I change which model a webhook watches?
      instructions:
      - text: Change the callback URL of webhook {idWebhook} under token {token} to {callbackURL}.
        slots:
          idWebhook: path.idWebhook
          token: path.token
          callbackURL: query.callbackURL
      - text: Make token {token}'s webhook {idWebhook} watch {idModel} instead.
        slots:
          token: path.token
          idWebhook: path.idWebhook
          idModel: query.idModel
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tokens/{token}/webhooks/{idWebhook}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a webhook created by a token
      effect: destructive
      questions:
      - How do I stop a webhook from sending callbacks?
      - Can I delete one webhook without revoking the token?
      instructions:
      - text: Delete webhook {idWebhook} under token {token}.
        slots:
          idWebhook: path.idWebhook
          token: path.token
      - text: Stop callbacks from token {token}'s webhook {idWebhook}.
        slots:
          token: path.token
          idWebhook: path.idWebhook
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tokens/{token}/'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a token (trailing-slash endpoint)
      effect: destructive
      questions:
      - Is there a plain delete-token endpoint at the trailing-slash token path?
      - How do I delete a token record outright via the plain /tokens/ path with a trailing slash?
      instructions:
      - text: Delete token {token} using the trailing-slash endpoint.
        slots:
          token: path.token
      - text: Erase token record {token} via the /tokens/ path.
        slots:
          token: path.token
      method: generated
      generated: '2026-09-26'