# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Nylas Applications API
  version: 1.0.0
extends: openapi/nylas-applications-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: 7
- target: $.paths['/v3/applications'].get
  update:
    x-apievangelist-phrasing:
      intent: View my Nylas application settings
      effect: read
      questions:
      - How can I see the region, environment and branding of my application?
      - Where do I find my Nylas application's configuration details?
      instructions:
      - text: Show my application's settings.
      - text: Get the application object for this API key.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/applications'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update application branding and hosted auth
      effect: write
      questions:
      - Can I change the branding shown on my application's hosted authentication page?
      - How do I update my application's hosted authentication settings through the API?
      instructions:
      - text: Update my application's branding to {branding}.
        slots:
          branding: requestBody.branding
      - text: Set the hosted authentication settings for my app to {hosted_authentication}.
        slots:
          hosted_authentication: requestBody.hosted_authentication
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/applications/redirect-uris'].get
  update:
    x-apievangelist-phrasing:
      intent: List my application's callback URIs
      effect: read
      questions:
      - Which redirect URIs are registered on my application?
      - How do I see all the callback URLs users can return to after auth?
      instructions:
      - text: List every callback URI on my application.
      - text: Show all registered redirect URIs.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/applications/redirect-uris'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a new callback URI
      effect: write
      questions:
      - How do I add a redirect URI so users return to my app after authenticating?
      - What platform is used if I don't specify one for a new callback URI?
      instructions:
      - text: Add a new callback URI to my application.
      - text: Register another redirect URI for the web platform.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/applications/redirect-uris/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve one callback URI
      effect: read
      questions:
      - Can I look up a single callback URI by its ID?
      - What settings are stored on a specific redirect URI?
      instructions:
      - text: Get callback URI {id}.
        slots:
          id: path.id
      - text: Show the details of redirect URI {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/applications/redirect-uris/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a callback URI
      effect: destructive
      questions:
      - How do I delete a redirect URI I no longer use?
      - Can I remove an old callback URL from my application?
      instructions:
      - text: Delete callback URI {id}.
        slots:
          id: path.id
      - text: Remove redirect URI {id} from my application.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v3/applications/redirect-uris/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change an existing callback URI
      effect: write
      questions:
      - Can I edit the URL or platform of a callback URI I already registered?
      - Does updating a redirect URI keep its platform if I leave it out?
      instructions:
      - text: Update callback URI {id}.
        slots:
          id: path.id
      - text: Edit the settings on redirect URI {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'