Adobe · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Adobe CC Libraries APIs Test Library Service - Public API

5 actions 5 updates phrasing extends openapi/adobe-library-service-public-api-openapi.yml

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

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 5

$.info

$.paths['/api/v1/public/libraries/{libraryId}'].get

$.paths['/api/v1/public/libraries/{libraryId}'].head

$.paths['/api/v1/public/libraries/{libraryId}/elements'].get

$.paths['/api/v1/public/libraries/{libraryId}/elements/{elementId}'].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 CC Libraries APIs Test Library Service - Public API
  version: 1.0.0
extends: openapi/adobe-library-service-public-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: 4
- target: $.paths['/api/v1/public/libraries/{libraryId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a publicly shared library
      effect: read
      questions:
      - Can I read a library someone shared publicly with a link?
      - Is it possible to fetch a public library through the CDN?
      instructions:
      - text: Get public library {libraryId}.
        slots:
          libraryId: path.libraryId
      - text: Open public library {libraryId} using share link {linkId}.
        slots:
          libraryId: path.libraryId
          linkId: query.linkId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/public/libraries/{libraryId}'].head
  update:
    x-apievangelist-phrasing:
      intent: Check that a public library exists
      effect: read
      questions:
      - How can I check that a shared public library link still works?
      - Can I get just the headers of a public library?
      instructions:
      - text: Check whether public library {libraryId} is available.
        slots:
          libraryId: path.libraryId
      - text: Check the headers of public library {libraryId} for link {linkId}.
        slots:
          libraryId: path.libraryId
          linkId: query.linkId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/public/libraries/{libraryId}/elements'].get
  update:
    x-apievangelist-phrasing:
      intent: List elements of a public library
      effect: read
      questions:
      - What elements are in a library that was shared publicly?
      - Can I filter a public library's elements by type?
      instructions:
      - text: List the elements of public library {libraryId}.
        slots:
          libraryId: path.libraryId
      - text: Show elements of type {type} in public library {libraryId}.
        slots:
          type: query.type
          libraryId: path.libraryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/public/libraries/{libraryId}/elements/{elementId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one element from a public library
      effect: read
      questions:
      - Can I fetch a single element from a publicly shared library?
      - What does one element of a public library look like?
      instructions:
      - text: Get element {elementId} from public library {libraryId}.
        slots:
          elementId: path.elementId
          libraryId: path.libraryId
      - text: Show element {elementId} of shared library {libraryId} via link {linkId}.
        slots:
          elementId: path.elementId
          libraryId: path.libraryId
          linkId: query.linkId
      method: generated
      generated: '2026-09-26'