# 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-suite-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: Retrieve a public Creative Cloud library
      effect: read
      questions:
      - How do I read the details of a publicly shared Creative Cloud library?
      - Can I fetch a public library through a share link ID?
      instructions:
      - text: Show public library {library}.
        slots:
          library: path.libraryId
      - text: Get public library {library} via share link {link}.
        slots:
          library: path.libraryId
          link: 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:
      - Can I check whether a public library is still available without downloading it?
      - How do I get just the headers, like the ETag, of a public library?
      instructions:
      - text: Check whether public library {library} exists.
        slots:
          library: path.libraryId
      - text: Fetch only the headers for public library {library} using link {link}.
        slots:
          library: path.libraryId
          link: query.linkId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/public/libraries/{libraryId}/elements'].get
  update:
    x-apievangelist-phrasing:
      intent: List the elements in a public library
      effect: read
      questions:
      - What colors, graphics and other assets are in a public library?
      - Can I list a public library's elements filtered by type or group?
      instructions:
      - text: List the elements in public library {library}.
        slots:
          library: path.libraryId
      - text: Show {limit} elements of type {type} from public library {library}.
        slots:
          limit: query.limit
          type: query.type
          library: path.libraryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/public/libraries/{libraryId}/elements/{elementId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Retrieve one element from a public library
      effect: read
      questions:
      - How do I pull a single asset out of a public Creative Cloud library?
      - Can I fetch one library element by its element ID?
      instructions:
      - text: Show element {element} from public library {library}.
        slots:
          element: path.elementId
          library: path.libraryId
      - text: Get element {element} in library {library} via share link {link}.
        slots:
          element: path.elementId
          library: path.libraryId
          link: query.linkId
      method: generated
      generated: '2026-09-26'