# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Azure DevOps Git Repositories API
  version: 1.0.0
extends: openapi/microsoft-azure-devops-repositories-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: 6
- target: $.paths['/git/repositories'].get
  update:
    x-apievangelist-phrasing:
      intent: List Git repositories
      effect: read
      questions:
      - What Git repositories are in my Azure DevOps project?
      - Can I include hidden repositories in the list?
      instructions:
      - text: List the Git repositories in the project.
      - text: List all repositories including hidden ones, using API version {apiVersion}.
        slots:
          apiVersion: query.api-version
      method: generated
      generated: '2026-09-26'
- target: $.paths['/git/repositories'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a Git repository
      effect: write
      questions:
      - How do I create a new Git repo in a project?
      - Can I create a repository as a fork of an existing one?
      instructions:
      - text: Create a repository named {name} in project {project}.
        slots:
          name: requestBody.name
          project: requestBody.project
      - text: Fork {parentRepository} into a new repository {name} in project {project}.
        slots:
          parentRepository: requestBody.parentRepository
          name: requestBody.name
          project: requestBody.project
      method: generated
      generated: '2026-09-26'
- target: $.paths['/git/repositories/{repositoryId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a repository
      effect: read
      questions:
      - What is the default branch and clone URL of a repository?
      - Can I see which repository a fork came from?
      instructions:
      - text: Show repository {repositoryId}.
        slots:
          repositoryId: path.repositoryId
      - text: Get repository {repositoryId} with its parent fork details.
        slots:
          repositoryId: path.repositoryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/git/repositories/{repositoryId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a repository
      effect: destructive
      questions:
      - Does deleting a repository also delete its pull requests?
      - Is removing a Git repository permanent?
      instructions:
      - text: Delete repository {repositoryId}.
        slots:
          repositoryId: path.repositoryId
      - text: Permanently remove Git repo {repositoryId} and all its contents.
        slots:
          repositoryId: path.repositoryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/git/repositories/{repositoryId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename or reconfigure a repository
      effect: write
      questions:
      - How do I rename a Git repository or change its default branch?
      - Can I disable a repository without deleting it?
      instructions:
      - text: Rename repository {repositoryId} to {name}.
        slots:
          repositoryId: path.repositoryId
          name: requestBody.name
      - text: Set the default branch of {repositoryId} to {defaultBranch}.
        slots:
          repositoryId: path.repositoryId
          defaultBranch: requestBody.defaultBranch
      - text: Set disabled to {isDisabled} on repository {repositoryId}.
        slots:
          isDisabled: requestBody.isDisabled
          repositoryId: path.repositoryId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/git/repositories/{repositoryId}/items'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse files and folders in a repository
      effect: read
      questions:
      - How do I see the files in a folder of a repo at a certain branch?
      - Can I list a repository's tree recursively?
      instructions:
      - text: List the files under {scopePath} in repository {repositoryId}.
        slots:
          scopePath: query.scopePath
          repositoryId: path.repositoryId
      - text: Browse {scopePath} of {repositoryId} at version {version} with recursion {recursionLevel}.
        slots:
          scopePath: query.scopePath
          repositoryId: path.repositoryId
          version: query.versionDescriptor.version
          recursionLevel: query.recursionLevel
      method: generated
      generated: '2026-09-26'