# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Adobe Launch Builds API
  version: 1.0.0
extends: openapi/adobe-launch-builds-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: 10
- target: $.paths['/libraries/{LIBRARY_ID}/builds'].get
  update:
    x-apievangelist-phrasing:
      intent: List a tag library's builds
      effect: read
      questions:
      - What builds have been made from a tag library?
      - Can I filter a tag library's builds by status to find failed ones?
      instructions:
      - text: List the builds of tag library {LIBRARY_ID}.
        slots:
          LIBRARY_ID: path.LIBRARY_ID
      - text: Show builds with status {status} for tag library {LIBRARY_ID}.
        slots:
          LIBRARY_ID: 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 tag library
      effect: write
      questions:
      - How do I kick off a build of a tag library without sending a payload?
      - Are a tag build's settings taken from its parent library?
      instructions:
      - text: Start a build of tag library {LIBRARY_ID}.
        slots:
          LIBRARY_ID: path.LIBRARY_ID
      - text: Build tag library {LIBRARY_ID} so its changes can be tested.
        slots:
          LIBRARY_ID: path.LIBRARY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/builds/{BUILD_ID}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a tag build
      effect: read
      questions:
      - How can I check whether a tag build succeeded?
      - What is the current status of one tag library build?
      instructions:
      - text: Look up tag build {BUILD_ID}.
        slots:
          BUILD_ID: path.BUILD_ID
      - text: Check the status of tag build {BUILD_ID}.
        slots:
          BUILD_ID: path.BUILD_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/builds/{BUILD_ID}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Republish a tag build
      effect: write
      questions:
      - Does republishing a tag build require the build ID in both the path and the payload?
      - Can I push an existing tag build out again without rebuilding?
      instructions:
      - text: Republish tag build {BUILD_ID} with payload {data}.
        slots:
          BUILD_ID: path.BUILD_ID
          data: requestBody.data
      - text: Republish tag build {BUILD_ID}.
        slots:
          BUILD_ID: path.BUILD_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{libraryId}/builds'].get
  update:
    x-apievangelist-phrasing:
      intent: List builds for an event forwarding library
      effect: read
      questions:
      - Which builds exist for my event forwarding library?
      - Can I filter an event forwarding library's builds by creation date?
      instructions:
      - text: List the builds for event forwarding library {libraryId}.
        slots:
          libraryId: path.libraryId
      - text: Show builds for event forwarding library {libraryId} created after {created_at}.
        slots:
          libraryId: path.libraryId
          created_at: query.filter[created_at]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/libraries/{libraryId}/builds'].post
  update:
    x-apievangelist-phrasing:
      intent: Compile an event forwarding library
      effect: write
      questions:
      - How do I compile an event forwarding library into a deployable build?
      - Can I trigger a server-side library build from the API?
      instructions:
      - text: Compile event forwarding library {libraryId} into a build.
        slots:
          libraryId: path.libraryId
      - text: Create a deployment build for event forwarding library {libraryId}.
        slots:
          libraryId: path.libraryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/builds/{buildId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an event forwarding build
      effect: read
      questions:
      - How do I look up an event forwarding build by its ID?
      - Did my event forwarding build finish successfully?
      instructions:
      - text: Fetch event forwarding build {buildId}.
        slots:
          buildId: path.buildId
      - text: Check whether event forwarding build {buildId} succeeded.
        slots:
          buildId: path.buildId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/builds/{buildId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Republish an event forwarding build
      effect: write
      questions:
      - Can I republish an existing event forwarding build?
      - How do I redeploy a server-side build that already exists?
      instructions:
      - text: Republish event forwarding build {buildId}.
        slots:
          buildId: path.buildId
      - text: Redeploy the existing server-side build {buildId}.
        slots:
          buildId: path.buildId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/builds/{buildId}/environment'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the environment a build deploys to
      effect: read
      questions:
      - Which environment was a build deployed to?
      - Is this build going to development, staging or production?
      instructions:
      - text: Get the environment for build {buildId}.
        slots:
          buildId: path.buildId
      - text: Tell me which environment build {buildId} was deployed to.
        slots:
          buildId: path.buildId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/builds/{buildId}/library'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the library a build was compiled from
      effect: read
      questions:
      - Which library was a given build compiled from?
      - How can I trace a build back to its source library?
      instructions:
      - text: Get the library for build {buildId}.
        slots:
          buildId: path.buildId
      - text: Tell me which library build {buildId} was compiled from.
        slots:
          buildId: path.buildId
      method: generated
      generated: '2026-09-26'