Adobe Suite · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Adobe Suite Identity API

4 actions 4 updates phrasing extends openapi/adobe-suite-identity-api-openapi.yml

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

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 4

$.info

$.paths['/identity/identity'].get

$.paths['/identity/oauth/token'].get

$.paths['/identity/oauth/token'].post

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 Adobe Suite Identity API
  version: 1.0.0
extends: openapi/adobe-suite-identity-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: 3
- target: $.paths['/identity/identity'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up an identity's XID
      effect: read
      questions:
      - How do I get the XID for an identity when I know its namespace and value?
      - Can I resolve an email or ECID in a namespace to its identity string?
      instructions:
      - text: Get the XID for identity {id} in namespace {namespace}.
        slots:
          id: query.id
          namespace: query.namespace
      - text: Resolve identity {id} in namespace ID {nsid}.
        slots:
          id: query.id
          nsid: query.nsid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/identity/oauth/token'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Marketo access token with GET
      effect: read
      questions:
      - How do I get a Marketo Engage access token with a GET request?
      - Does requesting an access token count against my API call limit?
      instructions:
      - text: Fetch an access token via GET with grant type {grant_type}.
        slots:
          grant_type: query.grant_type
      - text: Request a Marketo token over GET using client credentials and grant type {grant_type}.
        slots:
          grant_type: query.grant_type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/identity/oauth/token'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a Marketo access token with POST
      effect: write
      questions:
      - Can I request a Marketo access token with a POST instead of a GET?
      - What's the POST form of the token endpoint?
      instructions:
      - text: Request an access token by POST with grant type {grant_type}.
        slots:
          grant_type: query.grant_type
      - text: POST my client credentials to get a new token, grant type {grant_type}.
        slots:
          grant_type: query.grant_type
      method: generated
      generated: '2026-09-26'