API Evangelist conversational phrasing for Reactor Libraries API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Reactor Libraries API
  version: 1.0.0
extends: openapi/adobe-suite-libraries-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: 30
- target: $.paths['/properties/{PROPERTY_ID}/libraries'].get
  update:
    x-apievangelist-phrasing:
      intent: List the libraries in a tags property
      effect: read
      questions:
      - What libraries exist in my Adobe tags property?
      - Can I filter a property's libraries by state or only show stale ones?
      - Which libraries in this property were updated recently?
      instructions:
      - text: List the libraries in property {property}.
        slots:
          property: path.PROPERTY_ID
      - text: Show libraries in property {property} that are in state {state}.
        slots:
          property: path.PROPERTY_ID
          state: query.state
      - text: Find the library named {name} in property {property}.
        slots:
          property: path.PROPERTY_ID
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/libraries'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a library in a tags property
      effect: write
      questions:
      - How do I start a new library to bundle tag changes for publishing?
      - What do I need to supply to create a library under a property?
      instructions:
      - text: Create a new library in property {property}.
        slots:
          property: path.PROPERTY_ID
      - text: 'Set up a library in property {property} using this definition: {data}.'
        slots:
          property: path.PROPERTY_ID
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a library's details
      effect: read
      questions:
      - How do I look up one tags library by its ID?
      - What state is a given library in right now?
      instructions:
      - text: Show me library {library}.
        slots:
          library: path.LIBRARY_ID
      - text: Get the current state and name of library {library}.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a library
      effect: destructive
      questions:
      - How do I permanently remove a tags library I no longer need?
      - Can I delete a library outright rather than just detaching its resources?
      instructions:
      - text: Delete library {library}.
        slots:
          library: path.LIBRARY_ID
      - text: Remove library {library} entirely.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename a library or move it through publishing
      effect: write
      questions:
      - How do I rename a tags library?
      - Can I transition a library to submitted or approved through the API?
      - What action do I send to move a library to the next publishing state?
      instructions:
      - text: 'Rename library {library} with this payload: {data}.'
        slots:
          library: path.LIBRARY_ID
          data: requestBody.data
      - text: Submit library {library} for approval in the publishing flow.
        slots:
          library: path.LIBRARY_ID
      - text: Approve library {library} so it can be published.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/property'].get
  update:
    x-apievangelist-phrasing:
      intent: Find which property a library belongs to
      effect: read
      questions:
      - Which tags property owns this library?
      - How do I get from a library back to its parent property?
      instructions:
      - text: Show the property that library {library} belongs to.
        slots:
          library: path.LIBRARY_ID
      - text: Get the parent property of library {library}.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/builds'].get
  update:
    x-apievangelist-phrasing:
      intent: List a library's builds
      effect: read
      questions:
      - How do I see all the builds that were made from a library?
      - Can I filter a library's builds by build status?
      instructions:
      - text: List the builds for library {library}.
        slots:
          library: path.LIBRARY_ID
      - text: Show builds of library {library} with status {status}.
        slots:
          library: path.LIBRARY_ID
          status: query.status
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/builds'].post
  update:
    x-apievangelist-phrasing:
      intent: Build a library
      effect: write
      questions:
      - How do I kick off a build for a tags library?
      - Do I need to send a payload when building a library?
      instructions:
      - text: Build library {library}.
        slots:
          library: path.LIBRARY_ID
      - text: Start a new build of library {library} now.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/environment'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the environment a library is assigned to
      effect: read
      questions:
      - Which environment is this library currently deployed to?
      - How do I see full details of a library's environment?
      instructions:
      - text: Show the environment assigned to library {library}.
        slots:
          library: path.LIBRARY_ID
      - text: Get environment details for library {library}.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/upstream_library'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a library's upstream library
      effect: read
      questions:
      - What library sits upstream of this one in the publishing flow?
      - How can I see the library this one builds on top of?
      instructions:
      - text: Show the upstream library of library {library}.
        slots:
          library: path.LIBRARY_ID
      - text: Get the library upstream from {library}.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/data_elements'].get
  update:
    x-apievangelist-phrasing:
      intent: List the data elements in a library
      effect: read
      questions:
      - What data elements are included in a given library?
      - How do I page through the full data element records a library contains?
      instructions:
      - text: List the data elements in library {library}.
        slots:
          library: path.LIBRARY_ID
      - text: Show full data element details for library {library}.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/relationships/data_elements'].get
  update:
    x-apievangelist-phrasing:
      intent: List a library's data element links
      effect: read
      questions:
      - How do I get just the IDs of data elements linked to a library?
      - Can I see a library's data element relationships without full records?
      instructions:
      - text: List the data element relationship IDs for library {library}.
        slots:
          library: path.LIBRARY_ID
      - text: Show which data element IDs are linked to library {library}.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/relationships/data_elements'].post
  update:
    x-apievangelist-phrasing:
      intent: Add data elements to a library
      effect: write
      questions:
      - How do I add data elements to an existing library?
      - Can I attach several data elements to a library in one call?
      instructions:
      - text: Add data elements {data} to library {library}.
        slots:
          library: path.LIBRARY_ID
          data: requestBody.data
      - text: Include these data elements in library {library}.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/relationships/data_elements'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove data elements from a library
      effect: destructive
      questions:
      - How do I take specific data elements out of a library?
      - Can I detach a data element from a library without deleting it?
      instructions:
      - text: Remove data elements {data} from library {library}.
        slots:
          library: path.LIBRARY_ID
          data: requestBody.data
      - text: Detach these data elements from library {library}.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/relationships/data_elements'].patch
  update:
    x-apievangelist-phrasing:
      intent: Replace all data elements in a library
      effect: write
      questions:
      - How do I overwrite a library's full set of data elements at once?
      - Is there a way to swap every data element in a library for a new list?
      instructions:
      - text: Replace the data elements in library {library} with {data}.
        slots:
          library: path.LIBRARY_ID
          data: requestBody.data
      - text: Reset library {library} so it holds only these data elements.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/relationships/environment'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the environment link of a library
      effect: read
      questions:
      - How do I see just the environment ID a library is linked to?
      - Is this library attached to any environment at all?
      instructions:
      - text: Show the environment relationship for library {library}.
        slots:
          library: path.LIBRARY_ID
      - text: Check whether library {library} is linked to an environment.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/relationships/environment'].delete
  update:
    x-apievangelist-phrasing:
      intent: Unassign a library from its environment
      effect: destructive
      questions:
      - How do I detach a library from its environment?
      - Can I clear a library's environment assignment?
      instructions:
      - text: Remove the environment from library {library}.
        slots:
          library: path.LIBRARY_ID
      - text: Unassign library {library} from its environment.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/relationships/environment'].patch
  update:
    x-apievangelist-phrasing:
      intent: Assign a library to an environment
      effect: write
      questions:
      - How do I point a library at a development or staging environment?
      - Can I change which environment a library is assigned to?
      instructions:
      - text: Assign library {library} to environment {data}.
        slots:
          library: path.LIBRARY_ID
          data: requestBody.data
      - text: Set the environment for library {library}.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/extensions'].get
  update:
    x-apievangelist-phrasing:
      intent: List the extensions in a library
      effect: read
      questions:
      - What extensions are packaged in this library?
      - How do I get full extension records for a library?
      instructions:
      - text: List the extensions in library {library}.
        slots:
          library: path.LIBRARY_ID
      - text: Show full extension details for library {library}.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/relationships/extensions'].get
  update:
    x-apievangelist-phrasing:
      intent: List a library's extension links
      effect: read
      questions:
      - How do I get only the extension IDs linked to a library?
      - Can I see a library's extension relationships as bare references?
      instructions:
      - text: List the extension relationship IDs for library {library}.
        slots:
          library: path.LIBRARY_ID
      - text: Show which extension IDs are linked to library {library}.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/relationships/extensions'].post
  update:
    x-apievangelist-phrasing:
      intent: Add extensions to a library
      effect: write
      questions:
      - How do I add an extension to a library before building it?
      - Can I add more than one extension to a library at once?
      instructions:
      - text: Add extensions {data} to library {library}.
        slots:
          library: path.LIBRARY_ID
          data: requestBody.data
      - text: Include these extensions in library {library}.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/relationships/extensions'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove extensions from a library
      effect: destructive
      questions:
      - How do I take extensions out of a library?
      - Can I drop an extension from a library without deleting the extension itself?
      instructions:
      - text: Remove the extensions from library {library}.
        slots:
          library: path.LIBRARY_ID
      - text: Detach extensions from library {library}.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/relationships/extensions'].patch
  update:
    x-apievangelist-phrasing:
      intent: Replace all extensions in a library
      effect: write
      questions:
      - How do I overwrite the whole set of extensions in a library?
      - Is there a call that swaps every extension in a library for a new list?
      instructions:
      - text: Replace the extensions in library {library} with {data}.
        slots:
          library: path.LIBRARY_ID
          data: requestBody.data
      - text: Reset library {library} so it holds only these extensions.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/rules'].get
  update:
    x-apievangelist-phrasing:
      intent: List the rules in a library
      effect: read
      questions:
      - Which rules are included in a given library?
      - How do I get full rule records for everything in a library?
      instructions:
      - text: List the rules in library {library}.
        slots:
          library: path.LIBRARY_ID
      - text: Show full rule details for library {library}.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/relationships/rules'].get
  update:
    x-apievangelist-phrasing:
      intent: List a library's rule links
      effect: read
      questions:
      - How do I get only the rule IDs linked to a library?
      - Can I list a library's rule relationships without the full rule data?
      instructions:
      - text: List the rule relationship IDs for library {library}.
        slots:
          library: path.LIBRARY_ID
      - text: Show which rule IDs are linked to library {library}.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/relationships/rules'].post
  update:
    x-apievangelist-phrasing:
      intent: Add rules to a library
      effect: write
      questions:
      - How do I add rules to a library I'm preparing to publish?
      - Can I attach several rules to a library in a single request?
      instructions:
      - text: Add rules {data} to library {library}.
        slots:
          library: path.LIBRARY_ID
          data: requestBody.data
      - text: Include these rules in library {library}.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/relationships/rules'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove rules from a library
      effect: destructive
      questions:
      - How do I take rules out of a library?
      - Can I detach a rule from a library but keep the rule itself?
      instructions:
      - text: Remove rules {data} from library {library}.
        slots:
          library: path.LIBRARY_ID
          data: requestBody.data
      - text: Detach these rules from library {library}.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/relationships/rules'].patch
  update:
    x-apievangelist-phrasing:
      intent: Replace all rules in a library
      effect: write
      questions:
      - How do I overwrite a library's entire rule list at once?
      - Is there a way to swap every rule in a library for a new set?
      instructions:
      - text: Replace the rules in library {library} with {data}.
        slots:
          library: path.LIBRARY_ID
          data: requestBody.data
      - text: Reset library {library} so it holds only these rules.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/notes'].get
  update:
    x-apievangelist-phrasing:
      intent: List the notes on a library
      effect: read
      questions:
      - What notes have people left on this library?
      - Can I search a library's notes by their text?
      instructions:
      - text: List the notes on library {library}.
        slots:
          library: path.LIBRARY_ID
      - text: Find notes on library {library} that mention {text}.
        slots:
          library: path.LIBRARY_ID
          text: query.text
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{LIBRARY_ID}/notes'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a note to a library
      effect: write
      questions:
      - How do I leave a comment on a tags library for my team?
      - Can I attach a note to a library through the API?
      instructions:
      - text: Add a note to library {library}.
        slots:
          library: path.LIBRARY_ID
      - text: Leave a note on library {library} explaining this release.
        slots:
          library: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'