WSO2 · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for WSO2 API Manager - Developer Portal Application Keys API

14 actions 14 updates phrasing extends openapi/wso2-application-keys-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for WSO2's API. It is a proposal applied on top of the contract, not a document WSO2 publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 14

$.info
$.paths['/applications/{applicationId}/generate-keys'].post
$.paths['/applications/{applicationId}/map-keys'].post
$.paths['/applications/{applicationId}/keys'].get
$.paths['/applications/{applicationId}/keys/{keyType}'].get
$.paths['/applications/{applicationId}/keys/{keyType}'].put
$.paths['/applications/{applicationId}/keys/{keyType}/regenerate-secret'].post
$.paths['/applications/{applicationId}/keys/{keyType}/clean-up'].post
$.paths['/applications/{applicationId}/oauth-keys'].get
$.paths['/applications/{applicationId}/oauth-keys/{keyMappingId}'].get
$.paths['/applications/{applicationId}/oauth-keys/{keyMappingId}'].put
$.paths['/applications/{applicationId}/oauth-keys/{keyMappingId}'].delete
$.paths['/applications/{applicationId}/oauth-keys/{keyMappingId}/regenerate-secret'].post
$.paths['/applications/{applicationId}/oauth-keys/{keyMappingId}/clean-up'].post

OpenAPI Overlay

Raw ↑ 
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for WSO2 API Manager - Developer Portal Application Keys API
  version: 1.0.0
extends: openapi/wso2-application-keys-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 13
- target: $.paths['/applications/{applicationId}/generate-keys'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate consumer keys for an app
      effect: write
      questions:
      - Can I generate a consumer key and secret for my application?
      - Which grant types can I enable when generating production keys?
      instructions:
      - text: Generate {keyType} keys for application {applicationId} with grant types {grantTypesToBeSupported}.
        slots:
          keyType: requestBody.keyType
          applicationId: path.applicationId
          grantTypesToBeSupported: requestBody.grantTypesToBeSupported
      - text: Create {keyType} credentials for app {applicationId} using key manager {keyManager} and grants {grantTypesToBeSupported}.
        slots:
          keyType: requestBody.keyType
          applicationId: path.applicationId
          keyManager: requestBody.keyManager
          grantTypesToBeSupported: requestBody.grantTypesToBeSupported
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{applicationId}/map-keys'].post
  update:
    x-apievangelist-phrasing:
      intent: Map existing OAuth keys to an app
      effect: write
      questions:
      - Can I attach an OAuth client I already have to an application?
      - Is there a way to bring my own consumer key instead of generating one?
      instructions:
      - text: Map consumer key {consumerKey} to application {applicationId} as {keyType}.
        slots:
          consumerKey: requestBody.consumerKey
          applicationId: path.applicationId
          keyType: requestBody.keyType
      - text: Link existing {keyType} key {consumerKey} from key manager {keyManager} to app {applicationId}.
        slots:
          keyType: requestBody.keyType
          consumerKey: requestBody.consumerKey
          keyManager: requestBody.keyManager
          applicationId: path.applicationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{applicationId}/keys'].get
  update:
    x-apievangelist-phrasing:
      intent: List an app's keys by key type
      effect: read
      questions:
      - What production and sandbox keys does my application have?
      - Can I list the consumer keys of an app on the older key-type endpoint?
      instructions:
      - text: List all keys of application {applicationId}.
        slots:
          applicationId: path.applicationId
      - text: Show the production and sandbox credentials for app {applicationId}.
        slots:
          applicationId: path.applicationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{applicationId}/keys/{keyType}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an app's keys of one key type
      effect: read
      questions:
      - Can I see just the production key details of my application?
      - What does the sandbox key of an app look like, by key type?
      instructions:
      - text: Get the {keyType} key details of application {applicationId}.
        slots:
          keyType: path.keyType
          applicationId: path.applicationId
      - text: Show {keyType} credentials for app {applicationId} in group {groupId}.
        slots:
          keyType: path.keyType
          applicationId: path.applicationId
          groupId: query.groupId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{applicationId}/keys/{keyType}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update grant types by key type
      effect: write
      questions:
      - Can I change the callback URL of my production keys by key type?
      - Which grant types can I switch on for an app's sandbox keys?
      instructions:
      - text: Update the {keyType} keys of application {applicationId} with callback URL {callbackUrl}.
        slots:
          keyType: path.keyType
          applicationId: path.applicationId
          callbackUrl: requestBody.callbackUrl
      - text: Set grant types {supportedGrantTypes} on the {keyType} keys of app {applicationId}.
        slots:
          supportedGrantTypes: requestBody.supportedGrantTypes
          keyType: path.keyType
          applicationId: path.applicationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{applicationId}/keys/{keyType}/regenerate-secret'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate a secret by key type
      effect: write
      questions:
      - Can I rotate the consumer secret of my production keys?
      - Is there a way to issue a fresh secret for an app's sandbox key type?
      instructions:
      - text: Regenerate the {keyType} consumer secret of application {applicationId}.
        slots:
          keyType: path.keyType
          applicationId: path.applicationId
      - text: Rotate the secret for the {keyType} keys of app {applicationId}.
        slots:
          keyType: path.keyType
          applicationId: path.applicationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{applicationId}/keys/{keyType}/clean-up'].post
  update:
    x-apievangelist-phrasing:
      intent: Clean up failed keys by key type
      effect: destructive
      questions:
      - What do I do when generating production keys failed halfway?
      - Can I clear out broken keys of one key type after a failed generation?
      instructions:
      - text: Clean up the {keyType} keys of application {applicationId} after a failed generation.
        slots:
          keyType: path.keyType
          applicationId: path.applicationId
      - text: Reset the half-created {keyType} keys of app {applicationId}.
        slots:
          keyType: path.keyType
          applicationId: path.applicationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{applicationId}/oauth-keys'].get
  update:
    x-apievangelist-phrasing:
      intent: List an app's OAuth key mappings
      effect: read
      questions:
      - Which OAuth key mappings across key managers does my application have?
      - Can I list an app's keys from every key manager on the oauth-keys endpoint?
      instructions:
      - text: List the OAuth key mappings of application {applicationId}.
        slots:
          applicationId: path.applicationId
      - text: Show every key manager credential mapped to app {applicationId}.
        slots:
          applicationId: path.applicationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{applicationId}/oauth-keys/{keyMappingId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one OAuth key mapping
      effect: read
      questions:
      - Can I see the details of a single key mapping on my application?
      - What consumer key is stored under a particular key mapping ID?
      instructions:
      - text: Get key mapping {keyMappingId} of application {applicationId}.
        slots:
          keyMappingId: path.keyMappingId
          applicationId: path.applicationId
      - text: Show OAuth key mapping {keyMappingId} for app {applicationId} in group {groupId}.
        slots:
          keyMappingId: path.keyMappingId
          applicationId: path.applicationId
          groupId: query.groupId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{applicationId}/oauth-keys/{keyMappingId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update grant types of a key mapping
      effect: write
      questions:
      - Can I change the callback URL on one specific key mapping?
      - Which grant types can I enable on a key manager mapping of my app?
      instructions:
      - text: Set callback URL {callbackUrl} on key mapping {keyMappingId} of application {applicationId}.
        slots:
          callbackUrl: requestBody.callbackUrl
          keyMappingId: path.keyMappingId
          applicationId: path.applicationId
      - text: Enable grant types {supportedGrantTypes} on mapping {keyMappingId} of app {applicationId}.
        slots:
          supportedGrantTypes: requestBody.supportedGrantTypes
          keyMappingId: path.keyMappingId
          applicationId: path.applicationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{applicationId}/oauth-keys/{keyMappingId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an app's generated OAuth keys
      effect: destructive
      questions:
      - Can I remove keys I generated for an application?
      - How do I delete one key mapping from my app?
      instructions:
      - text: Remove key mapping {keyMappingId} from application {applicationId}.
        slots:
          keyMappingId: path.keyMappingId
          applicationId: path.applicationId
      - text: Delete the generated OAuth keys under mapping {keyMappingId} of app {applicationId}.
        slots:
          keyMappingId: path.keyMappingId
          applicationId: path.applicationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{applicationId}/oauth-keys/{keyMappingId}/regenerate-secret'].post
  update:
    x-apievangelist-phrasing:
      intent: Regenerate a key mapping's secret
      effect: write
      questions:
      - Can I rotate the secret of one key manager mapping?
      - Is it possible to get a new consumer secret for a specific key mapping ID?
      instructions:
      - text: Regenerate the consumer secret of key mapping {keyMappingId} on application {applicationId}.
        slots:
          keyMappingId: path.keyMappingId
          applicationId: path.applicationId
      - text: Rotate the secret for OAuth mapping {keyMappingId} of app {applicationId}.
        slots:
          keyMappingId: path.keyMappingId
          applicationId: path.applicationId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/applications/{applicationId}/oauth-keys/{keyMappingId}/clean-up'].post
  update:
    x-apievangelist-phrasing:
      intent: Clean up a failed key mapping
      effect: destructive
      questions:
      - What can I do when key generation failed for one key mapping?
      - Can I clear out a broken key mapping after a failed generation?
      instructions:
      - text: Clean up key mapping {keyMappingId} of application {applicationId} after a failed generation.
        slots:
          keyMappingId: path.keyMappingId
          applicationId: path.applicationId
      - text: Reset the failed OAuth mapping {keyMappingId} on app {applicationId}.
        slots:
          keyMappingId: path.keyMappingId
          applicationId: path.applicationId
      method: generated
      generated: '2026-10-01'

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this
  • find_overlaysBrowse and filter every overlay in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This overlay 
curl "https://apis.io/api/v1/overlays/wso2-application-keys-api-phrasing-overlay"
All openapi overlays 
curl "https://apis.io/api/v1/overlays?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.