Adobe Suite · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Adobe Status API Reference Registry API

8 actions 8 updates phrasing extends openapi/adobe-suite-registry-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 8

$.info

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

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

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

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

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

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

$.paths['/api/v1/messages/{locale}'].get

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 Status API Reference Registry API
  version: 1.0.0
extends: openapi/adobe-suite-registry-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['/api/v1/clouds'].get
  update:
    x-apievangelist-phrasing:
      intent: List Adobe product clouds
      effect: read
      questions:
      - What top-level Adobe product families does the status registry know about?
      - Can I look up a single cloud by name?
      instructions:
      - text: List all Adobe clouds.
      - text: Find the cloud named {cloudName}.
        slots:
          cloudName: query.cloudName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/products'].get
  update:
    x-apievangelist-phrasing:
      intent: List Adobe products and services
      effect: read
      questions:
      - Which products and services are tracked across the clouds?
      - Can I filter the product list down to one cloud?
      instructions:
      - text: List the products in cloud {cloudId}.
        slots:
          cloudId: query.cloudId
      - text: Find the product called {productName}.
        slots:
          productName: query.productName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/eventTypes'].get
  update:
    x-apievangelist-phrasing:
      intent: List status event types
      effect: read
      questions:
      - What kinds of events can affect Adobe products, like outages or maintenance?
      - Which event types appear on the status registry?
      instructions:
      - text: List the status event types.
      - text: Show me every type of event that can impact a product.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/regions'].get
  update:
    x-apievangelist-phrasing:
      intent: List regions that status events can affect
      effect: read
      questions:
      - Which geographic regions can a status event be reported for?
      - What regions does the status registry use?
      instructions:
      - text: List the regions used for status events.
      - text: Show all the regions that can be impacted by an incident.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/locales'].get
  update:
    x-apievangelist-phrasing:
      intent: List supported status message locales
      effect: read
      questions:
      - What languages are status event messages available in?
      - Which locale codes can I use to fetch translated status messages?
      instructions:
      - text: List the supported message locales.
      - text: Show which locales status messages come in.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/messages'].get
  update:
    x-apievangelist-phrasing:
      intent: List status event messages in all locales
      effect: read
      questions:
      - How do I get the message text for events impacting Adobe products?
      - Can I pull one specific status message by its token across every language?
      instructions:
      - text: List all status event messages.
      - text: Get the status message with token {messageToken} in every locale.
        slots:
          messageToken: query.messageToken
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/messages/{locale}'].get
  update:
    x-apievangelist-phrasing:
      intent: List status event messages for one locale
      effect: read
      questions:
      - Can I get status event messages translated into a single language?
      - How do I fetch only the French versions of incident messages?
      instructions:
      - text: List status messages in locale {locale}.
        slots:
          locale: path.locale
      - text: Get message {messageToken} in locale {locale} only.
        slots:
          messageToken: query.messageToken
          locale: path.locale
      method: generated
      generated: '2026-09-26'