# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Kinde Management Callbacks API
  version: 1.0.0
extends: openapi/kinde-callbacks-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: 8
- target: $.paths['/api/v1/applications/{app_id}/auth_redirect_urls'].get
  update:
    x-apievangelist-phrasing:
      intent: List an app's redirect callback URLs
      effect: read
      questions:
      - Which callback URLs can users be redirected to after signing in to my app?
      - Can I see the allowed sign-in redirect URLs for an application?
      instructions:
      - text: List the sign-in callback URLs for application {app_id}.
        slots:
          app_id: path.app_id
      - text: Show allowed redirect URLs after login for app {app_id}.
        slots:
          app_id: path.app_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/applications/{app_id}/auth_redirect_urls'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace all redirect callback URLs
      effect: write
      questions:
      - Is there a way to overwrite the entire list of sign-in callback URLs for an app?
      - Can I reset an application's redirect URLs to a new set?
      instructions:
      - text: Replace the callback URLs of app {app_id} with {urls}.
        slots:
          app_id: path.app_id
          urls: requestBody.urls
      - text: Overwrite every sign-in redirect URL for application {app_id}.
        slots:
          app_id: path.app_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/applications/{app_id}/auth_redirect_urls'].post
  update:
    x-apievangelist-phrasing:
      intent: Add redirect callback URLs
      effect: write
      questions:
      - Can I add another sign-in callback URL without removing the existing ones?
      - What's needed to allow a new domain as a login redirect for my app?
      instructions:
      - text: Add {urls} as sign-in callback URLs on app {app_id}.
        slots:
          urls: requestBody.urls
          app_id: path.app_id
      - text: Append a login redirect URL {urls} to application {app_id}.
        slots:
          urls: requestBody.urls
          app_id: path.app_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/applications/{app_id}/auth_redirect_urls'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete redirect callback URLs
      effect: destructive
      questions:
      - How do I remove specific sign-in callback URLs from an application?
      - Can I delete an old login redirect URL?
      instructions:
      - text: Remove callback URLs {urls} from app {app_id}.
        slots:
          urls: query.urls
          app_id: path.app_id
      - text: Delete the sign-in redirect {urls} for application {app_id}.
        slots:
          urls: query.urls
          app_id: path.app_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/applications/{app_id}/auth_logout_urls'].get
  update:
    x-apievangelist-phrasing:
      intent: List an app's logout redirect URLs
      effect: read
      questions:
      - Where can users be sent after they log out of my app?
      - Can I see an application's allowed logout redirect URLs?
      instructions:
      - text: List the logout redirect URLs for app {app_id}.
        slots:
          app_id: path.app_id
      - text: Show where application {app_id} may redirect after sign-out.
        slots:
          app_id: path.app_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/applications/{app_id}/auth_logout_urls'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace all logout redirect URLs
      effect: write
      questions:
      - Is there a call that overwrites the whole list of post-logout URLs for an app?
      - Can I reset logout redirects to a fresh set?
      instructions:
      - text: Replace the logout URLs of app {app_id} with {urls}.
        slots:
          app_id: path.app_id
          urls: requestBody.urls
      - text: Overwrite all sign-out redirect URLs for application {app_id}.
        slots:
          app_id: path.app_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/applications/{app_id}/auth_logout_urls'].post
  update:
    x-apievangelist-phrasing:
      intent: Add logout redirect URLs
      effect: write
      questions:
      - Can I add a new post-logout URL while keeping the current ones?
      - How do I allow another page as a sign-out destination?
      instructions:
      - text: Add {urls} as a logout redirect URL on app {app_id}.
        slots:
          urls: requestBody.urls
          app_id: path.app_id
      - text: Append sign-out redirect {urls} to application {app_id}.
        slots:
          urls: requestBody.urls
          app_id: path.app_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/applications/{app_id}/auth_logout_urls'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete logout redirect URLs
      effect: destructive
      questions:
      - How do I remove a logout redirect URL from an app?
      - Can I delete several post-logout URLs at once?
      instructions:
      - text: Remove logout URLs {urls} from app {app_id}.
        slots:
          urls: query.urls
          app_id: path.app_id
      - text: Delete sign-out redirect {urls} for application {app_id}.
        slots:
          urls: query.urls
          app_id: path.app_id
      method: generated
      generated: '2026-09-26'