API Evangelist conversational phrasing for Adobe Launch Hosts API

# 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 Hosts API
  version: 1.0.0
extends: openapi/adobe-launch-hosts-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: 11
- target: $.paths['/properties/{PROPERTY_ID}/hosts'].get
  update:
    x-apievangelist-phrasing:
      intent: List a tag property's hosts
      effect: read
      questions:
      - Which hosts can my Adobe tags property deploy builds to?
      - Can I filter a property's hosts by name?
      instructions:
      - text: List the hosts of property {property}.
        slots:
          property: path.PROPERTY_ID
      - text: Find the host named {name} in property {property}.
        slots:
          property: path.PROPERTY_ID
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/hosts'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a host for a tag property
      effect: write
      questions:
      - How do I set up an SFTP host so builds deploy to my own server?
      - What attributes does a new host need?
      instructions:
      - text: Create a host for property {property} with {data}.
        slots:
          property: path.PROPERTY_ID
          data: requestBody.data
      - text: Add an SFTP host to property {property} via the uppercase PROPERTY_ID endpoint.
        slots:
          property: path.PROPERTY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosts/{HOST_ID}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a host by ID
      effect: read
      questions:
      - Where can I see a host's type and connection settings?
      - Is this host Adobe-managed or SFTP?
      instructions:
      - text: Get the details of host {host}.
        slots:
          host: path.HOST_ID
      - text: Show host {host} from the uppercase-ID endpoint.
        slots:
          host: path.HOST_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosts/{HOST_ID}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a host
      effect: destructive
      questions:
      - How do I remove a host I no longer deploy to?
      - Can a deleted host be restored?
      instructions:
      - text: Delete host {host}.
        slots:
          host: path.HOST_ID
      - text: Remove host {host} via the uppercase HOST_ID endpoint.
        slots:
          host: path.HOST_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosts/{HOST_ID}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an SFTP host
      effect: write
      questions:
      - Which kinds of hosts can be edited after creation?
      - Can I change the server path of my SFTP host?
      instructions:
      - text: Update SFTP host {host} with {data}.
        slots:
          host: path.HOST_ID
          data: requestBody.data
      - text: Edit SFTP host {host} through the uppercase-ID PATCH endpoint.
        slots:
          host: path.HOST_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosts/{HOST_ID}/property'].get
  update:
    x-apievangelist-phrasing:
      intent: Find the property a host belongs to
      effect: read
      questions:
      - Which property owns this host?
      - Can I trace a host ID back to its property?
      instructions:
      - text: Show the property that host {host} belongs to.
        slots:
          host: path.HOST_ID
      - text: Look up the parent property of host {host}.
        slots:
          host: path.HOST_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{propertyId}/hosts'].get
  update:
    x-apievangelist-phrasing:
      intent: List a property's hosts with date filters
      effect: read
      questions:
      - Can I list hosts created after a certain date?
      - Which hosts in a property were updated recently?
      instructions:
      - text: List hosts in property {property} created on or after {created}.
        slots:
          property: path.propertyId
          created: query.filter[created_at]
      - text: List hosts in property {property} updated since {updated}.
        slots:
          property: path.propertyId
          updated: query.filter[updated_at]
      - text: Filter hosts in property {property} by name {name} using the filter parameter.
        slots:
          property: path.propertyId
          name: query.filter[name]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{propertyId}/hosts'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a host (alternate)
      effect: write
      questions:
      - Is there a propertyId endpoint for creating a host?
      - Can I create a host using the camelCase property path?
      instructions:
      - text: Create a host under property {property} with {data} via the propertyId endpoint.
        slots:
          property: path.propertyId
          data: requestBody.data
      - text: Add a host to property {property} using the propertyId path.
        slots:
          property: path.propertyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosts/{hostId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up a host (alternate)
      effect: read
      questions:
      - Is there a hostId endpoint for looking up one host?
      - Can I fetch a host through the camelCase hostId path?
      instructions:
      - text: Look up host {hostId} via the hostId endpoint.
        slots:
          hostId: path.hostId
      - text: Fetch host {hostId} using the camelCase path.
        slots:
          hostId: path.hostId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosts/{hostId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a host (alternate)
      effect: destructive
      questions:
      - Does the hostId delete endpoint return 204 when it succeeds?
      - Can I delete a host through the camelCase hostId path?
      instructions:
      - text: Delete host {hostId} via the hostId endpoint.
        slots:
          hostId: path.hostId
      - text: Remove host {hostId} using the camelCase path.
        slots:
          hostId: path.hostId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/hosts/{hostId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an SFTP host (alternate)
      effect: write
      questions:
      - Is there a hostId PATCH endpoint for modifying SFTP hosts?
      - Can I modify an SFTP host's attributes through the camelCase path?
      instructions:
      - text: Modify SFTP host {hostId} with {data} via the hostId endpoint.
        slots:
          hostId: path.hostId
          data: requestBody.data
      - text: Update SFTP host {hostId} using the camelCase path.
        slots:
          hostId: path.hostId
      method: generated
      generated: '2026-09-26'