# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Clickup Authorization API
  version: 1.0.0
extends: openapi/clickup-authorization-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: 3
- target: $.paths['/v2/oauth/token'].post
  update:
    x-apievangelist-phrasing:
      intent: Exchange an OAuth code for an access token
      effect: write
      questions:
      - How do I turn an OAuth authorization code into a ClickUp access token?
      - Do I need this token exchange if I'm using a personal API token?
      instructions:
      - text: Exchange code {code} for an access token using client {client_id} and secret {client_secret}.
        slots:
          code: requestBody.code
          client_id: requestBody.client_id
          client_secret: requestBody.client_secret
      - text: Finish the OAuth flow for app {client_id} with secret {client_secret} and authorization code {code}.
        slots:
          client_id: requestBody.client_id
          client_secret: requestBody.client_secret
          code: requestBody.code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v2/user'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the authenticated user's account (v2)
      effect: read
      questions:
      - Which account is my token authenticated as, via the v2 endpoint?
      - How do I check the v2 details of the user behind my API token?
      instructions:
      - text: Via v2, show the account details of the authorized user.
      - text: Using v2, tell me who I'm authenticated as.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/user'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the current user's profile (unversioned)
      effect: read
      questions:
      - Which non-v2 endpoint returns my user ID, username, email and profile picture?
      - Can I read the current user's profile from the unversioned path?
      instructions:
      - text: On the unversioned path, get my user ID, username and email.
      - text: Using the non-v2 endpoint, fetch the current user's profile picture and username.
      method: generated
      generated: '2026-09-26'