# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for App Store Connect Ci Build Actions API
  version: 1.0.0
extends: openapi/ios-cibuildactions-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: 9
- target: $.paths['/v1/ciBuildActions/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Xcode Cloud build action
      effect: read
      questions:
      - How do I look up a single Xcode Cloud build action?
      - What's the status of one action within an Xcode Cloud build run?
      instructions:
      - text: Get Xcode Cloud build action {id}.
        slots:
          id: path.id
      - text: Show me the details of build action {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/ciBuildActions/{id}/relationships/artifacts'].get
  update:
    x-apievangelist-phrasing:
      intent: List artifact IDs of a build action
      effect: read
      questions:
      - Which artifact IDs did an Xcode Cloud build action produce?
      - Can I list only the artifact references of a build action?
      instructions:
      - text: List only the artifact IDs for build action {id}.
        slots:
          id: path.id
      - text: Return up to {limit} artifact linkages for Xcode Cloud action {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/ciBuildActions/{id}/artifacts'].get
  update:
    x-apievangelist-phrasing:
      intent: List artifacts produced by a build action
      effect: read
      questions:
      - What artifacts did my Xcode Cloud build action produce, with details?
      - Where can I see the outputs of a build action?
      instructions:
      - text: Show the artifacts of build action {id}.
        slots:
          id: path.id
      - text: List up to {limit} artifacts with details for Xcode Cloud action {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/ciBuildActions/{id}/relationships/buildRun'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the build run ID of a build action
      effect: read
      questions:
      - Which build run ID does this build action belong to?
      - Can I get only the build run reference for an Xcode Cloud action?
      instructions:
      - text: Give me only the build run ID for build action {id}.
        slots:
          id: path.id
      - text: Return the build run linkage of Xcode Cloud action {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/ciBuildActions/{id}/buildRun'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the build run a build action belongs to
      effect: read
      questions:
      - Which Xcode Cloud build run did this action run in?
      - Where do I see the full build run details for a build action?
      instructions:
      - text: Show the build run that build action {id} belongs to.
        slots:
          id: path.id
      - text: Fetch the full build run record for Xcode Cloud action {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/ciBuildActions/{id}/relationships/issues'].get
  update:
    x-apievangelist-phrasing:
      intent: List issue IDs of a build action
      effect: read
      questions:
      - Which issue IDs were reported by an Xcode Cloud build action?
      - Can I list only the issue references of a build action?
      instructions:
      - text: List only the issue IDs for build action {id}.
        slots:
          id: path.id
      - text: Return up to {limit} issue linkages for Xcode Cloud action {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/ciBuildActions/{id}/issues'].get
  update:
    x-apievangelist-phrasing:
      intent: List issues reported by a build action
      effect: read
      questions:
      - What errors and warnings did my Xcode Cloud build action report?
      - How do I see the issues found during a build action?
      instructions:
      - text: Show the issues reported by build action {id}.
        slots:
          id: path.id
      - text: List up to {limit} issues with details for Xcode Cloud action {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/ciBuildActions/{id}/relationships/testResults'].get
  update:
    x-apievangelist-phrasing:
      intent: List test result IDs of a build action
      effect: read
      questions:
      - Which test result IDs belong to an Xcode Cloud build action?
      - Can I list only the test result references of a build action?
      instructions:
      - text: List only the test result IDs for build action {id}.
        slots:
          id: path.id
      - text: Return up to {limit} test result linkages for Xcode Cloud action {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/ciBuildActions/{id}/testResults'].get
  update:
    x-apievangelist-phrasing:
      intent: List test results of a build action
      effect: read
      questions:
      - Which tests passed or failed in my Xcode Cloud build action?
      - Where can I see the test results of a build action?
      instructions:
      - text: Show the test results of build action {id}.
        slots:
          id: path.id
      - text: List up to {limit} test results with details for Xcode Cloud action {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'