# 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 Environments API
  version: 1.0.0
extends: openapi/adobe-launch-environments-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: 18
- target: $.paths['/properties/{PROPERTY_ID}/environments'].get
  update:
    x-apievangelist-phrasing:
      intent: List a tag property's environments
      effect: read
      questions:
      - Which environments does my Adobe tags property have?
      - Can I filter a property's environments by stage, like development or production?
      - How do I find an environment by its token?
      instructions:
      - text: List the environments in property {property}.
        slots:
          property: path.PROPERTY_ID
      - text: Show environments in property {property} at stage {stage}.
        slots:
          property: path.PROPERTY_ID
          stage: query.stage
      - text: Find the environment with token {token} in property {property}.
        slots:
          property: path.PROPERTY_ID
          token: query.token
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/environments'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an environment in a tag property
      effect: write
      questions:
      - What do I need to add a development environment to a tags property?
      - Does a new environment need to be linked to a host?
      instructions:
      - text: Create an environment in property {property} with {data}.
        slots:
          property: path.PROPERTY_ID
          data: requestBody.data
      - text: Add a development environment to tags property {property} via the uppercase PROPERTY_ID endpoint.
        slots:
          property: path.PROPERTY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/environments/{ENVIRONMENT_ID}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up an environment by ID
      effect: read
      questions:
      - Where can I see one environment's stage and embed details?
      - Can I look up a tags environment by its ID?
      instructions:
      - text: Get the details of environment {environment}.
        slots:
          environment: path.ENVIRONMENT_ID
      - text: Show environment {environment} from the uppercase-ID endpoint.
        slots:
          environment: path.ENVIRONMENT_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/environments/{ENVIRONMENT_ID}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an environment
      effect: destructive
      questions:
      - How do I remove an old development environment from a property?
      - Is deleting a tags environment reversible?
      instructions:
      - text: Delete environment {environment}.
        slots:
          environment: path.ENVIRONMENT_ID
      - text: Remove unused environment {environment} via the uppercase ENVIRONMENT_ID endpoint.
        slots:
          environment: path.ENVIRONMENT_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/environments/{ENVIRONMENT_ID}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an environment
      effect: write
      questions:
      - Can I rename an environment or change its host link?
      - How do I edit an environment's attributes?
      instructions:
      - text: Update environment {environment} with {data}.
        slots:
          environment: path.ENVIRONMENT_ID
          data: requestBody.data
      - text: Edit environment {environment} through the uppercase-ID PATCH endpoint.
        slots:
          environment: path.ENVIRONMENT_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/environments/{ENVIRONMENT_ID}/builds'].get
  update:
    x-apievangelist-phrasing:
      intent: List an environment's builds
      effect: read
      questions:
      - Which builds have been deployed to this environment?
      - Can I page through an environment's build history?
      instructions:
      - text: List the builds deployed to environment {environment}.
        slots:
          environment: path.ENVIRONMENT_ID
      - text: Show page {page} of builds for environment {environment}.
        slots:
          environment: path.ENVIRONMENT_ID
          page: query.page[number]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/environments/{ENVIRONMENT_ID}/secrets'].get
  update:
    x-apievangelist-phrasing:
      intent: List an environment's secrets
      effect: read
      questions:
      - Which secrets are attached to this environment?
      - Can I page through the secrets used by an environment?
      instructions:
      - text: List the secrets in environment {environment}.
        slots:
          environment: path.ENVIRONMENT_ID
      - text: Show {size} secrets per page for environment {environment}.
        slots:
          environment: path.ENVIRONMENT_ID
          size: query.page[size]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/environments/{ENVIRONMENT_ID}/host'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the host an environment deploys to
      effect: read
      questions:
      - Which host does this environment deploy its builds to?
      - Can I see the full host record for an environment?
      instructions:
      - text: Show the host for environment {environment}.
        slots:
          environment: path.ENVIRONMENT_ID
      - text: Fetch the full host details of environment {environment} via the uppercase-ID endpoint.
        slots:
          environment: path.ENVIRONMENT_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/environments/{ENVIRONMENT_ID}/relationships/host'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an environment's host link
      effect: read
      questions:
      - Can I get just the host ID an environment points to?
      - What host relationship does this environment have?
      instructions:
      - text: Show the host relationship for environment {environment}.
        slots:
          environment: path.ENVIRONMENT_ID
      - text: Give me only the host reference linked to environment {environment}.
        slots:
          environment: path.ENVIRONMENT_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/environments/{ENVIRONMENT_ID}/library'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the library in an environment
      effect: read
      questions:
      - Which library is currently assigned to this environment?
      - Is any library occupying my development environment?
      instructions:
      - text: Show the library assigned to environment {environment}.
        slots:
          environment: path.ENVIRONMENT_ID
      - text: Check which library is in environment {environment}.
        slots:
          environment: path.ENVIRONMENT_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/environments/{ENVIRONMENT_ID}/property'].get
  update:
    x-apievangelist-phrasing:
      intent: Find the property an environment belongs to
      effect: read
      questions:
      - Which property owns this environment?
      - Can I go from an environment ID back to its property?
      instructions:
      - text: Show the property that owns environment {environment}.
        slots:
          environment: path.ENVIRONMENT_ID
      - text: Look up the parent property of environment {environment}.
        slots:
          environment: path.ENVIRONMENT_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{propertyId}/environments'].get
  update:
    x-apievangelist-phrasing:
      intent: List environments of an event forwarding property
      effect: read
      questions:
      - Which environments does my event forwarding property have?
      - Can I page through event forwarding environments?
      instructions:
      - text: List the environments in event forwarding property {property}.
        slots:
          property: path.propertyId
      - text: Show page {page} of environments for event forwarding property {property}.
        slots:
          property: path.propertyId
          page: query.page[number]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{propertyId}/environments'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an environment (alternate)
      effect: write
      questions:
      - How do I add an environment to an event forwarding property?
      - Is there a propertyId endpoint for creating environments?
      instructions:
      - text: Create an environment in event forwarding property {property} with {data}.
        slots:
          property: path.propertyId
          data: requestBody.data
      - text: Add an environment to property {property} via the propertyId endpoint.
        slots:
          property: path.propertyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/environments/{environmentId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up an environment (alternate)
      effect: read
      questions:
      - Can I fetch an event forwarding environment by its ID?
      - Is there an environmentId endpoint to look up one environment?
      instructions:
      - text: Look up event forwarding environment {environmentId}.
        slots:
          environmentId: path.environmentId
      - text: Get environment {environmentId} via the environmentId endpoint.
        slots:
          environmentId: path.environmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/environments/{environmentId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an environment (alternate)
      effect: destructive
      questions:
      - How do I delete an event forwarding environment?
      - Does the environmentId delete endpoint return 204 on success?
      instructions:
      - text: Delete event forwarding environment {environmentId}.
        slots:
          environmentId: path.environmentId
      - text: Remove environment {environmentId} via the environmentId endpoint.
        slots:
          environmentId: path.environmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/environments/{environmentId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an environment (alternate)
      effect: write
      questions:
      - How do I change an event forwarding environment's attributes?
      - Is there an environmentId PATCH endpoint for environments?
      instructions:
      - text: Update event forwarding environment {environmentId} with {data}.
        slots:
          environmentId: path.environmentId
          data: requestBody.data
      - text: Modify environment {environmentId} via the environmentId endpoint.
        slots:
          environmentId: path.environmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/environments/{environmentId}/host'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an environment's host (alternate)
      effect: read
      questions:
      - Which host configuration does an event forwarding environment use?
      - Can I read an environment's host via the environmentId endpoint?
      instructions:
      - text: Get the host configuration of event forwarding environment {environmentId}.
        slots:
          environmentId: path.environmentId
      - text: Show the host for environment {environmentId} via the environmentId endpoint.
        slots:
          environmentId: path.environmentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/environments/{environmentId}/builds'].get
  update:
    x-apievangelist-phrasing:
      intent: List an environment's builds (alternate)
      effect: read
      questions:
      - Which builds belong to an event forwarding environment?
      - Can I list builds via the environmentId endpoint?
      instructions:
      - text: List builds for event forwarding environment {environmentId}.
        slots:
          environmentId: path.environmentId
      - text: Show the builds of environment {environmentId} via the environmentId endpoint.
        slots:
          environmentId: path.environmentId
      method: generated
      generated: '2026-09-26'