Kinde · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Kinde Management Applications API

12 actions 12 updates phrasing extends openapi/kinde-applications-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Kinde's API. It is a proposal applied on top of the contract, not a document Kinde publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 12

$.info

$.paths['/api/v1/applications'].get

$.paths['/api/v1/applications'].post

$.paths['/api/v1/applications/{application_id}'].get

$.paths['/api/v1/applications/{application_id}'].delete

$.paths['/api/v1/applications/{application_id}'].patch

$.paths['/api/v1/applications/{application_id}/connections'].get

$.paths['/api/v1/applications/{application_id}/connections/{connection_id}'].post

$.paths['/api/v1/applications/{application_id}/connections/{connection_id}'].delete

$.paths['/api/v1/applications/{application_id}/properties'].get

$.paths['/api/v1/applications/{application_id}/properties/{property_key}'].put

$.paths['/api/v1/applications/{application_id}/tokens'].patch

OpenAPI Overlay

# 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 Applications API
  version: 1.0.0
extends: openapi/kinde-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: 11
- target: $.paths['/api/v1/applications'].get
  update:
    x-apievangelist-phrasing:
      intent: List applications
      effect: read
      questions:
      - Which applications and clients exist in my environment?
      - Can I sort and page through my list of applications?
      instructions:
      - text: List all my applications.
      - text: Show applications sorted by {sort}, {page_size} per page.
        slots:
          sort: query.sort
          page_size: query.page_size
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/applications'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an application
      effect: write
      questions:
      - How do I create a new application for my frontend or backend?
      - What application types can I create in Kinde?
      instructions:
      - text: Create a {type} application named {name}.
        slots:
          type: requestBody.type
          name: requestBody.name
      - text: Add a new application {name} of type {type} for organization {org_code}.
        slots:
          name: requestBody.name
          type: requestBody.type
          org_code: requestBody.org_code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/applications/{application_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an application
      effect: read
      questions:
      - Can I look up one application's settings by its ID?
      - Where do I see a single client's configuration?
      instructions:
      - text: Show application {application_id}.
        slots:
          application_id: path.application_id
      - text: Get the settings of application {application_id}.
        slots:
          application_id: path.application_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/applications/{application_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an application
      effect: destructive
      questions:
      - How do I delete an application I no longer use?
      - Can I permanently remove a client application?
      instructions:
      - text: Delete application {application_id}.
        slots:
          application_id: path.application_id
      - text: Remove the client application {application_id} permanently.
        slots:
          application_id: path.application_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/applications/{application_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an application's settings
      effect: write
      questions:
      - Can I rename an application or change its login and homepage URIs?
      - How do I edit an existing application's redirect and logout URIs in one update?
      instructions:
      - text: Rename application {application_id} to {name}.
        slots:
          application_id: path.application_id
          name: requestBody.name
      - text: Set the login URI of application {application_id} to {login_uri}.
        slots:
          application_id: path.application_id
          login_uri: requestBody.login_uri
      - text: Update application {application_id} homepage to {homepage_uri}.
        slots:
          application_id: path.application_id
          homepage_uri: requestBody.homepage_uri
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/applications/{application_id}/connections'].get
  update:
    x-apievangelist-phrasing:
      intent: List an application's auth connections
      effect: read
      questions:
      - Which sign-in connections are enabled for a given application?
      - Can I see the auth methods an application offers?
      instructions:
      - text: List the auth connections for application {application_id}.
        slots:
          application_id: path.application_id
      - text: Show which connections are enabled on application {application_id}.
        slots:
          application_id: path.application_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/applications/{application_id}/connections/{connection_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Enable a connection for an application
      effect: write
      questions:
      - How do I turn on an auth connection for one application?
      - Can I add a social or enterprise connection to an existing app?
      instructions:
      - text: Enable connection {connection_id} for application {application_id}.
        slots:
          connection_id: path.connection_id
          application_id: path.application_id
      - text: Turn on auth connection {connection_id} in application {application_id}.
        slots:
          connection_id: path.connection_id
          application_id: path.application_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/applications/{application_id}/connections/{connection_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Turn off a connection for an application
      effect: destructive
      questions:
      - How do I disable an auth connection on one application?
      - Can I stop an application from offering a particular sign-in method?
      instructions:
      - text: Disable connection {connection_id} for application {application_id}.
        slots:
          connection_id: path.connection_id
          application_id: path.application_id
      - text: Remove auth connection {connection_id} from application {application_id}.
        slots:
          connection_id: path.connection_id
          application_id: path.application_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/applications/{application_id}/properties'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an application's property values
      effect: read
      questions:
      - What custom property values are set on an application?
      - Can I read all properties stored against one application?
      instructions:
      - text: Show the property values for application {application_id}.
        slots:
          application_id: path.application_id
      - text: List custom properties set on application {application_id}.
        slots:
          application_id: path.application_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/applications/{application_id}/properties/{property_key}'].put
  update:
    x-apievangelist-phrasing:
      intent: Set an application property value
      effect: write
      questions:
      - How do I set a custom property value on an application?
      - Can I update a single property on an application by its key?
      instructions:
      - text: Set property {property_key} on application {application_id} to {value}.
        slots:
          property_key: path.property_key
          application_id: path.application_id
          value: requestBody.value
      - text: Update application {application_id}'s {property_key} property to {value}.
        slots:
          application_id: path.application_id
          property_key: path.property_key
          value: requestBody.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/applications/{application_id}/tokens'].patch
  update:
    x-apievangelist-phrasing:
      intent: Configure an application's token lifetimes
      effect: write
      questions:
      - How do I change the access token lifetime for an application?
      - Can I set how long refresh tokens and ID tokens last per application?
      - Is there a way to enable Hasura claim mapping for an app's tokens?
      instructions:
      - text: Set the access token lifetime of application {application_id} to {access_token_lifetime} seconds.
        slots:
          application_id: path.application_id
          access_token_lifetime: requestBody.access_token_lifetime
      - text: Make refresh tokens for application {application_id} last {refresh_token_lifetime} seconds.
        slots:
          application_id: path.application_id
          refresh_token_lifetime: requestBody.refresh_token_lifetime
      - text: Enable Hasura mapping on application {application_id} tokens.
        slots:
          application_id: path.application_id
      method: generated
      generated: '2026-09-26'