# 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 Scm Repositories API
  version: 1.0.0
extends: openapi/ios-scmrepositories-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: 6
- target: $.paths['/v1/scmRepositories'].get
  update:
    x-apievangelist-phrasing:
      intent: List Xcode Cloud source repositories
      effect: read
      questions:
      - Which Git repositories are connected to Xcode Cloud?
      - Can I filter connected repositories by ID?
      instructions:
      - text: List my Xcode Cloud repositories.
      - text: Show the connected repository with ID {repo}.
        slots:
          repo: query.filter[id]
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/scmRepositories/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Xcode Cloud repository
      effect: read
      questions:
      - What are the URLs and owner of a connected repository?
      - Can I look up one Xcode Cloud repository by ID?
      instructions:
      - text: Show repository {id}.
        slots:
          id: path.id
      - text: Get the details of Xcode Cloud repository {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/scmRepositories/{id}/relationships/gitReferences'].get
  update:
    x-apievangelist-phrasing:
      intent: List Git reference IDs of a repository
      effect: read
      questions:
      - Can I get just the branch and tag reference IDs for a repository?
      - Which Git reference identifiers does Xcode Cloud know about?
      instructions:
      - text: List only the Git reference IDs of repository {id}.
        slots:
          id: path.id
      - text: Return up to {limit} reference linkages for repository {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/scmRepositories/{id}/gitReferences'].get
  update:
    x-apievangelist-phrasing:
      intent: List branches and tags of a repository
      effect: read
      questions:
      - What branches and tags does Xcode Cloud see in my repo?
      - Can I see full Git reference details for a connected repository?
      instructions:
      - text: Show the branches and tags of repository {id}.
        slots:
          id: path.id
      - text: List the full Git references for repository {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/scmRepositories/{id}/relationships/pullRequests'].get
  update:
    x-apievangelist-phrasing:
      intent: List pull request IDs of a repository
      effect: read
      questions:
      - Can I get just the pull request IDs Xcode Cloud tracks for a repo?
      - Which pull request identifiers are linked to a repository?
      instructions:
      - text: List only the pull request IDs of repository {id}.
        slots:
          id: path.id
      - text: Return up to {limit} pull request linkages for repository {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/scmRepositories/{id}/pullRequests'].get
  update:
    x-apievangelist-phrasing:
      intent: List pull requests of a repository
      effect: read
      questions:
      - What open pull requests does Xcode Cloud see for my repository?
      - Can I get the title and branches of each pull request in a repo?
      instructions:
      - text: Show the pull requests for repository {id}.
        slots:
          id: path.id
      - text: List the full pull request details for repository {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'