# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Unity Build Automation Build Targets API
  version: 1.0.0
extends: openapi/unity-build-targets-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/orgs/{orgid}/projects/{projectid}/buildtargets'].get
  update:
    x-apievangelist-phrasing:
      intent: List a project's Cloud Build targets
      effect: read
      questions:
      - Which build targets are configured for my Unity Cloud Build project?
      - What platforms is my project currently set up to build for?
      instructions:
      - text: List all build targets in project {projectid} of org {orgid}.
        slots:
          projectid: path.projectid
          orgid: path.orgid
      - text: Show the configured build targets for project {projectid} under org {orgid}.
        slots:
          projectid: path.projectid
          orgid: path.orgid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{orgid}/projects/{projectid}/buildtargets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a build target for a platform
      effect: write
      questions:
      - How do I add a new platform build target to my project?
      - Can I create a build target that starts out disabled?
      instructions:
      - text: Create build target {name} for platform {platform} in project {projectid}, org {orgid}.
        slots:
          name: requestBody.name
          platform: requestBody.platform
          projectid: path.projectid
          orgid: path.orgid
      - text: 'Add a {platform} build target called {name} to project {projectid} under org {orgid}, enabled: {enabled}.'
        slots:
          platform: requestBody.platform
          name: requestBody.name
          projectid: path.projectid
          orgid: path.orgid
          enabled: requestBody.enabled
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{orgid}/projects/{projectid}/buildtargets/{buildtargetid}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a build target's configuration
      effect: read
      questions:
      - What settings does one of my build targets use?
      - Can I see how a specific build target is configured?
      instructions:
      - text: Show the configuration of build target {buildtargetid} in project {projectid}, org {orgid}.
        slots:
          buildtargetid: path.buildtargetid
          projectid: path.projectid
          orgid: path.orgid
      - text: Get build target {buildtargetid} settings for project {projectid} under org {orgid}.
        slots:
          buildtargetid: path.buildtargetid
          projectid: path.projectid
          orgid: path.orgid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{orgid}/projects/{projectid}/buildtargets/{buildtargetid}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a build target
      effect: destructive
      questions:
      - Can I remove a build target I no longer need?
      - What happens when I delete a build target configuration?
      instructions:
      - text: Delete build target {buildtargetid} from project {projectid} in org {orgid}.
        slots:
          buildtargetid: path.buildtargetid
          projectid: path.projectid
          orgid: path.orgid
      - text: Remove the build target {buildtargetid} configuration from project {projectid}, org {orgid}.
        slots:
          buildtargetid: path.buildtargetid
          projectid: path.projectid
          orgid: path.orgid
      method: generated
      generated: '2026-10-01'
- target: $.paths['/orgs/{orgid}/projects/{projectid}/buildtargets/{buildtargetid}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a build target's settings
      effect: write
      questions:
      - Can I disable a build target without deleting it?
      - Is it possible to rename an existing build target or change its settings?
      instructions:
      - text: 'Disable build target {buildtargetid} in project {projectid}, org {orgid} (enabled: {enabled}).'
        slots:
          buildtargetid: path.buildtargetid
          projectid: path.projectid
          orgid: path.orgid
          enabled: requestBody.enabled
      - text: Rename build target {buildtargetid} in project {projectid} under org {orgid} to {name}.
        slots:
          buildtargetid: path.buildtargetid
          projectid: path.projectid
          orgid: path.orgid
          name: requestBody.name
      method: generated
      generated: '2026-10-01'