# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Nylas Manage API keys API
  version: 1.0.0
extends: openapi/nylas-manage-api-keys-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: 4
- target: $.paths['/v3/admin/applications/{application_id}/api-keys'].get
  update:
    x-apievangelist-phrasing:
      intent: List an application's API keys
      effect: read
      questions:
      - Which API keys exist for my application?
      - What do I need set up before I can manage API keys programmatically?
      instructions:
      - text: List API keys for application {application_id}.
        slots:
          application_id: path.application_id
      - text: Show every API key on app {application_id}.
        slots:
          application_id: path.application_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/admin/applications/{application_id}/api-keys'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new API key
      effect: write
      questions:
      - How do I generate a new API key for my application?
      - Can I make an API key that expires after a set number of days?
      instructions:
      - text: Create an API key named {name} for application {application_id}.
        slots:
          name: requestBody.name
          application_id: path.application_id
      - text: Generate a key for app {application_id} that expires in {expires_in} days.
        slots:
          application_id: path.application_id
          expires_in: requestBody.expires_in
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/admin/applications/{application_id}/api-keys/{api_key_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve one API key
      effect: read
      questions:
      - Can I look up a single API key's details and expiry?
      - How do I check when a specific API key was created?
      instructions:
      - text: Get API key {api_key_id} for application {application_id}.
        slots:
          api_key_id: path.api_key_id
          application_id: path.application_id
      - text: Show details of key {api_key_id} on app {application_id}.
        slots:
          api_key_id: path.api_key_id
          application_id: path.application_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/admin/applications/{application_id}/api-keys/{api_key_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Revoke an API key
      effect: destructive
      questions:
      - How do I revoke an API key that may have leaked?
      - Can I delete an old API key from my application?
      instructions:
      - text: Delete API key {api_key_id} from application {application_id}.
        slots:
          api_key_id: path.api_key_id
          application_id: path.application_id
      - text: Revoke key {api_key_id} on app {application_id}.
        slots:
          api_key_id: path.api_key_id
          application_id: path.application_id
      method: generated
      generated: '2026-09-26'