Azure Repos Git API

naftiko: 1.0.0-alpha2
info:
  label: Azure Repos Git API
  description: REST API for managing Git repositories, branches, commits, pull requests, pushes, and items in Azure Repos.
    Provides full programmatic control over Git-based source code hosted in Azure DevOps, including creating and reviewing
    pull requests, managing branches and tags, browsing repository content, and pushing commits.
  tags:
  - Microsoft
  - Azure
  - Repo
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: microsoft-azure-repo
    baseUri: https://dev.azure.com/myorganization/myproject/_apis
    description: Azure Repos Git API HTTP API.
    authentication:
      type: bearer
      token: '{{MICROSOFT_AZURE_REPO_TOKEN}}'
    resources:
    - name: git-repositories
      path: /git/repositories
      operations:
      - name: repositories-list
        method: GET
        description: Azure Repos List repositories
        inputParameters:
        - name: includeAllUrls
          in: query
          type: boolean
          description: Set to true to include all remote URLs in the response. Defaults to false.
        - name: includeHidden
          in: query
          type: boolean
          description: Set to true to include hidden repositories. Defaults to false.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: repositories-create
        method: POST
        description: Azure Repos Create a repository
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: git-repositories-repositoryid
      path: /git/repositories/{repositoryId}
      operations:
      - name: repositories-get
        method: GET
        description: Azure Repos Get a repository
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: repositories-update
        method: PATCH
        description: Azure Repos Update a repository
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: repositories-delete
        method: DELETE
        description: Azure Repos Delete a repository
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: git-repositories-repositoryid-pullrequests
      path: /git/repositories/{repositoryId}/pullrequests
      operations:
      - name: pullrequests-list
        method: GET
        description: Azure Repos List pull requests
        inputParameters:
        - name: searchCriteria.status
          in: query
          type: string
          description: Filter by pull request status. Defaults to active if unset.
        - name: searchCriteria.creatorId
          in: query
          type: string
          description: Filter by the identity ID of the pull request creator
        - name: searchCriteria.reviewerId
          in: query
          type: string
          description: Filter by the identity ID of a reviewer
        - name: searchCriteria.sourceRefName
          in: query
          type: string
          description: Filter by source branch name (e.g., refs/heads/feature)
        - name: searchCriteria.targetRefName
          in: query
          type: string
          description: Filter by target branch name (e.g., refs/heads/main)
        - name: searchCriteria.repositoryId
          in: query
          type: string
          description: Filter by target repository ID
        - name: searchCriteria.sourceRepositoryId
          in: query
          type: string
          description: Filter by source repository ID
        - name: searchCriteria.includeLinks
          in: query
          type: boolean
          description: Whether to include the _links field on shallow references
        - name: searchCriteria.minTime
          in: query
          type: string
          description: Filter pull requests created or closed after this date based on queryTimeRangeType
        - name: searchCriteria.maxTime
          in: query
          type: string
          description: Filter pull requests created or closed before this date based on queryTimeRangeType
        - name: searchCriteria.queryTimeRangeType
          in: query
          type: string
          description: The type of time range for minTime and maxTime. Defaults to created if unset.
        - name: $top
          in: query
          type: integer
          description: Number of pull requests to retrieve
        - name: $skip
          in: query
          type: integer
          description: Number of pull requests to skip
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: pullrequests-create
        method: POST
        description: Azure Repos Create a pull request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: git-repositories-repositoryid-pullrequests-pullr
      path: /git/repositories/{repositoryId}/pullrequests/{pullRequestId}
      operations:
      - name: pullrequests-get
        method: GET
        description: Azure Repos Get a pull request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: pullrequests-update
        method: PATCH
        description: Azure Repos Update a pull request
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: git-repositories-repositoryid-pullrequests-pullr
      path: /git/repositories/{repositoryId}/pullrequests/{pullRequestId}/reviewers
      operations:
      - name: pullrequestreviewers-list
        method: GET
        description: Azure Repos List pull request reviewers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: git-repositories-repositoryid-pullrequests-pullr
      path: /git/repositories/{repositoryId}/pullrequests/{pullRequestId}/reviewers/{reviewerId}
      operations:
      - name: pullrequestreviewers-createorupdate
        method: PUT
        description: Azure Repos Add or update a reviewer
        inputParameters:
        - name: reviewerId
          in: path
          type: string
          required: true
          description: ID of the reviewer identity
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: pullrequestreviewers-delete
        method: DELETE
        description: Azure Repos Remove a reviewer
        inputParameters:
        - name: reviewerId
          in: path
          type: string
          required: true
          description: ID of the reviewer identity to remove
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: git-repositories-repositoryid-pullrequests-pullr
      path: /git/repositories/{repositoryId}/pullrequests/{pullRequestId}/threads
      operations:
      - name: pullrequestthreads-list
        method: GET
        description: Azure Repos List pull request threads
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: pullrequestthreads-create
        method: POST
        description: Azure Repos Create a comment thread
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: git-repositories-repositoryid-pullrequests-pullr
      path: /git/repositories/{repositoryId}/pullrequests/{pullRequestId}/commits
      operations:
      - name: pullrequestcommits-list
        method: GET
        description: Azure Repos List pull request commits
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: git-repositories-repositoryid-commits
      path: /git/repositories/{repositoryId}/commits
      operations:
      - name: commits-list
        method: GET
        description: Azure Repos List commits
        inputParameters:
        - name: searchCriteria.itemVersion.version
          in: query
          type: string
          description: Branch name or tag to search (e.g., main, develop)
        - name: searchCriteria.itemVersion.versionType
          in: query
          type: string
          description: Type of version identifier
        - name: searchCriteria.itemPath
          in: query
          type: string
          description: Path of an item to filter commits that changed this path
        - name: searchCriteria.fromDate
          in: query
          type: string
          description: Start date for filtering commits
        - name: searchCriteria.toDate
          in: query
          type: string
          description: End date for filtering commits
        - name: searchCriteria.author
          in: query
          type: string
          description: Filter by author name or email
        - name: searchCriteria.$top
          in: query
          type: integer
          description: Maximum number of commits to return
        - name: searchCriteria.$skip
          in: query
          type: integer
          description: Number of commits to skip
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: git-repositories-repositoryid-commits-commitid
      path: /git/repositories/{repositoryId}/commits/{commitId}
      operations:
      - name: commits-get
        method: GET
        description: Azure Repos Get a commit
        inputParameters:
        - name: commitId
          in: path
          type: string
          required: true
          description: The SHA-1 hash of the commit
        - name: changeCount
          in: query
          type: integer
          description: Maximum number of changes to include
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: git-repositories-repositoryid-refs
      path: /git/repositories/{repositoryId}/refs
      operations:
      - name: refs-list
        method: GET
        description: Azure Repos List refs (branches and tags)
        inputParameters:
        - name: filter
          in: query
          type: string
          description: Filter refs by name prefix (e.g., heads/main, tags/v1)
        - name: includeLinks
          in: query
          type: boolean
          description: Include reference links in the response
        - name: includeStatuses
          in: query
          type: boolean
          description: Include status information for each ref
        - name: includeMyBranches
          in: query
          type: boolean
          description: Include only branches owned by the authenticated user
        - name: peelTags
          in: query
          type: boolean
          description: Annotated tags will populate the PeeledObjectId property
        - name: $top
          in: query
          type: integer
          description: Maximum number of refs to return
        - name: continuationToken
          in: query
          type: string
          description: Continuation token for paging through results
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: refs-update
        method: POST
        description: Azure Repos Create, update, or delete refs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: git-repositories-repositoryid-pushes
      path: /git/repositories/{repositoryId}/pushes
      operations:
      - name: pushes-list
        method: GET
        description: Azure Repos List pushes
        inputParameters:
        - name: $top
          in: query
          type: integer
          description: Number of pushes to return
        - name: $skip
          in: query
          type: integer
          description: Number of pushes to skip
        - name: searchCriteria.fromDate
          in: query
          type: string
          description: Start date for filtering pushes
        - name: searchCriteria.toDate
          in: query
          type: string
          description: End date for filtering pushes
        - name: searchCriteria.pusherId
          in: query
          type: string
          description: Filter by pusher identity ID
        - name: searchCriteria.refName
          in: query
          type: string
          description: Filter by branch name (e.g., refs/heads/main)
        - name: searchCriteria.includeRefUpdates
          in: query
          type: boolean
          description: Include ref update details in results
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: pushes-create
        method: POST
        description: Azure Repos Create a push
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: git-repositories-repositoryid-pushes-pushid
      path: /git/repositories/{repositoryId}/pushes/{pushId}
      operations:
      - name: pushes-get
        method: GET
        description: Azure Repos Get a push
        inputParameters:
        - name: pushId
          in: path
          type: integer
          required: true
          description: ID of the push
        - name: includeCommits
          in: query
          type: integer
          description: Number of commits to include
        - name: includeRefUpdates
          in: query
          type: boolean
          description: Include ref update details
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: git-repositories-repositoryid-items
      path: /git/repositories/{repositoryId}/items
      operations:
      - name: items-list
        method: GET
        description: Azure Repos List items (files and folders)
        inputParameters:
        - name: scopePath
          in: query
          type: string
          description: The path scope for items (e.g., /src or /README.md)
        - name: recursionLevel
          in: query
          type: string
          description: Level of recursion for folder listing
        - name: versionDescriptor.version
          in: query
          type: string
          description: Branch name, tag, or commit to get items from
        - name: versionDescriptor.versionType
          in: query
          type: string
          description: Type of version identifier
        - name: includeContentMetadata
          in: query
          type: boolean
          description: Include content metadata for items
        - name: latestProcessedChange
          in: query
          type: boolean
          description: Include the latest change for each item
        - name: includeLinks
          in: query
          type: boolean
          description: Include reference links
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: git-repositories-repositoryid-stats-branches
      path: /git/repositories/{repositoryId}/stats/branches
      operations:
      - name: stats-list
        method: GET
        description: Azure Repos List branch statistics
        inputParameters:
        - name: baseVersionDescriptor.version
          in: query
          type: string
          description: Base branch or commit to compare against
        - name: baseVersionDescriptor.versionType
          in: query
          type: string
          description: Type of the base version
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: microsoft-azure-repo-rest
    description: REST adapter for Azure Repos Git API.
    resources:
    - path: /git/repositories
      name: repositories-list
      operations:
      - method: GET
        name: repositories-list
        description: Azure Repos List repositories
        call: microsoft-azure-repo.repositories-list
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories
      name: repositories-create
      operations:
      - method: POST
        name: repositories-create
        description: Azure Repos Create a repository
        call: microsoft-azure-repo.repositories-create
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}
      name: repositories-get
      operations:
      - method: GET
        name: repositories-get
        description: Azure Repos Get a repository
        call: microsoft-azure-repo.repositories-get
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}
      name: repositories-update
      operations:
      - method: PATCH
        name: repositories-update
        description: Azure Repos Update a repository
        call: microsoft-azure-repo.repositories-update
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}
      name: repositories-delete
      operations:
      - method: DELETE
        name: repositories-delete
        description: Azure Repos Delete a repository
        call: microsoft-azure-repo.repositories-delete
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}/pullrequests
      name: pullrequests-list
      operations:
      - method: GET
        name: pullrequests-list
        description: Azure Repos List pull requests
        call: microsoft-azure-repo.pullrequests-list
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}/pullrequests
      name: pullrequests-create
      operations:
      - method: POST
        name: pullrequests-create
        description: Azure Repos Create a pull request
        call: microsoft-azure-repo.pullrequests-create
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}/pullrequests/{pullRequestId}
      name: pullrequests-get
      operations:
      - method: GET
        name: pullrequests-get
        description: Azure Repos Get a pull request
        call: microsoft-azure-repo.pullrequests-get
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}/pullrequests/{pullRequestId}
      name: pullrequests-update
      operations:
      - method: PATCH
        name: pullrequests-update
        description: Azure Repos Update a pull request
        call: microsoft-azure-repo.pullrequests-update
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}/pullrequests/{pullRequestId}/reviewers
      name: pullrequestreviewers-list
      operations:
      - method: GET
        name: pullrequestreviewers-list
        description: Azure Repos List pull request reviewers
        call: microsoft-azure-repo.pullrequestreviewers-list
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}/pullrequests/{pullRequestId}/reviewers/{reviewerId}
      name: pullrequestreviewers-createorupdate
      operations:
      - method: PUT
        name: pullrequestreviewers-createorupdate
        description: Azure Repos Add or update a reviewer
        call: microsoft-azure-repo.pullrequestreviewers-createorupdate
        with:
          reviewerId: rest.reviewerId
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}/pullrequests/{pullRequestId}/reviewers/{reviewerId}
      name: pullrequestreviewers-delete
      operations:
      - method: DELETE
        name: pullrequestreviewers-delete
        description: Azure Repos Remove a reviewer
        call: microsoft-azure-repo.pullrequestreviewers-delete
        with:
          reviewerId: rest.reviewerId
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}/pullrequests/{pullRequestId}/threads
      name: pullrequestthreads-list
      operations:
      - method: GET
        name: pullrequestthreads-list
        description: Azure Repos List pull request threads
        call: microsoft-azure-repo.pullrequestthreads-list
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}/pullrequests/{pullRequestId}/threads
      name: pullrequestthreads-create
      operations:
      - method: POST
        name: pullrequestthreads-create
        description: Azure Repos Create a comment thread
        call: microsoft-azure-repo.pullrequestthreads-create
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}/pullrequests/{pullRequestId}/commits
      name: pullrequestcommits-list
      operations:
      - method: GET
        name: pullrequestcommits-list
        description: Azure Repos List pull request commits
        call: microsoft-azure-repo.pullrequestcommits-list
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}/commits
      name: commits-list
      operations:
      - method: GET
        name: commits-list
        description: Azure Repos List commits
        call: microsoft-azure-repo.commits-list
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}/commits/{commitId}
      name: commits-get
      operations:
      - method: GET
        name: commits-get
        description: Azure Repos Get a commit
        call: microsoft-azure-repo.commits-get
        with:
          commitId: rest.commitId
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}/refs
      name: refs-list
      operations:
      - method: GET
        name: refs-list
        description: Azure Repos List refs (branches and tags)
        call: microsoft-azure-repo.refs-list
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}/refs
      name: refs-update
      operations:
      - method: POST
        name: refs-update
        description: Azure Repos Create, update, or delete refs
        call: microsoft-azure-repo.refs-update
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}/pushes
      name: pushes-list
      operations:
      - method: GET
        name: pushes-list
        description: Azure Repos List pushes
        call: microsoft-azure-repo.pushes-list
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}/pushes
      name: pushes-create
      operations:
      - method: POST
        name: pushes-create
        description: Azure Repos Create a push
        call: microsoft-azure-repo.pushes-create
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}/pushes/{pushId}
      name: pushes-get
      operations:
      - method: GET
        name: pushes-get
        description: Azure Repos Get a push
        call: microsoft-azure-repo.pushes-get
        with:
          pushId: rest.pushId
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}/items
      name: items-list
      operations:
      - method: GET
        name: items-list
        description: Azure Repos List items (files and folders)
        call: microsoft-azure-repo.items-list
        outputParameters:
        - type: object
          mapping: $.
    - path: /git/repositories/{repositoryId}/stats/branches
      name: stats-list
      operations:
      - method: GET
        name: stats-list
        description: Azure Repos List branch statistics
        call: microsoft-azure-repo.stats-list
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: microsoft-azure-repo-mcp
    transport: http
    description: MCP adapter for Azure Repos Git API for AI agent use.
    tools:
    - name: repositories-list
      description: Azure Repos List repositories
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-azure-repo.repositories-list
      with:
        includeAllUrls: tools.includeAllUrls
        includeHidden: tools.includeHidden
      inputParameters:
      - name: includeAllUrls
        type: boolean
        description: Set to true to include all remote URLs in the response. Defaults to false.
      - name: includeHidden
        type: boolean
        description: Set to true to include hidden repositories. Defaults to false.
      outputParameters:
      - type: object
        mapping: $.
    - name: repositories-create
      description: Azure Repos Create a repository
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-azure-repo.repositories-create
      outputParameters:
      - type: object
        mapping: $.
    - name: repositories-get
      description: Azure Repos Get a repository
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-azure-repo.repositories-get
      outputParameters:
      - type: object
        mapping: $.
    - name: repositories-update
      description: Azure Repos Update a repository
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-azure-repo.repositories-update
      outputParameters:
      - type: object
        mapping: $.
    - name: repositories-delete
      description: Azure Repos Delete a repository
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: microsoft-azure-repo.repositories-delete
      outputParameters:
      - type: object
        mapping: $.
    - name: pullrequests-list
      description: Azure Repos List pull requests
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-azure-repo.pullrequests-list
      with:
        searchCriteria.status: tools.searchCriteria.status
        searchCriteria.creatorId: tools.searchCriteria.creatorId
        searchCriteria.reviewerId: tools.searchCriteria.reviewerId
        searchCriteria.sourceRefName: tools.searchCriteria.sourceRefName
        searchCriteria.targetRefName: tools.searchCriteria.targetRefName
        searchCriteria.repositoryId: tools.searchCriteria.repositoryId
        searchCriteria.sourceRepositoryId: tools.searchCriteria.sourceRepositoryId
        searchCriteria.includeLinks: tools.searchCriteria.includeLinks
        searchCriteria.minTime: tools.searchCriteria.minTime
        searchCriteria.maxTime: tools.searchCriteria.maxTime
        searchCriteria.queryTimeRangeType: tools.searchCriteria.queryTimeRangeType
        $top: tools.$top
        $skip: tools.$skip
      inputParameters:
      - name: searchCriteria.status
        type: string
        description: Filter by pull request status. Defaults to active if unset.
      - name: searchCriteria.creatorId
        type: string
        description: Filter by the identity ID of the pull request creator
      - name: searchCriteria.reviewerId
        type: string
        description: Filter by the identity ID of a reviewer
      - name: searchCriteria.sourceRefName
        type: string
        description: Filter by source branch name (e.g., refs/heads/feature)
      - name: searchCriteria.targetRefName
        type: string
        description: Filter by target branch name (e.g., refs/heads/main)
      - name: searchCriteria.repositoryId
        type: string
        description: Filter by target repository ID
      - name: searchCriteria.sourceRepositoryId
        type: string
        description: Filter by source repository ID
      - name: searchCriteria.includeLinks
        type: boolean
        description: Whether to include the _links field on shallow references
      - name: searchCriteria.minTime
        type: string
        description: Filter pull requests created or closed after this date based on queryTimeRangeType
      - name: searchCriteria.maxTime
        type: string
        description: Filter pull requests created or closed before this date based on queryTimeRangeType
      - name: searchCriteria.queryTimeRangeType
        type: string
        description: The type of time range for minTime and maxTime. Defaults to created if unset.
      - name: $top
        type: integer
        description: Number of pull requests to retrieve
      - name: $skip
        type: integer
        description: Number of pull requests to skip
      outputParameters:
      - type: object
        mapping: $.
    - name: pullrequests-create
      description: Azure Repos Create a pull request
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-azure-repo.pullrequests-create
      outputParameters:
      - type: object
        mapping: $.
    - name: pullrequests-get
      description: Azure Repos Get a pull request
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-azure-repo.pullrequests-get
      outputParameters:
      - type: object
        mapping: $.
    - name: pullrequests-update
      description: Azure Repos Update a pull request
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-azure-repo.pullrequests-update
      outputParameters:
      - type: object
        mapping: $.
    - name: pullrequestreviewers-list
      description: Azure Repos List pull request reviewers
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-azure-repo.pullrequestreviewers-list
      outputParameters:
      - type: object
        mapping: $.
    - name: pullrequestreviewers-createorupdate
      description: Azure Repos Add or update a reviewer
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: microsoft-azure-repo.pullrequestreviewers-createorupdate
      with:
        reviewerId: tools.reviewerId
      inputParameters:
      - name: reviewerId
        type: string
        description: ID of the reviewer identity
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: pullrequestreviewers-delete
      description: Azure Repos Remove a reviewer
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: microsoft-azure-repo.pullrequestreviewers-delete
      with:
        reviewerId: tools.reviewerId
      inputParameters:
      - name: reviewerId
        type: string
        description: ID of the reviewer identity to remove
        required: true
      outputParameters:
      - type: object
        mapping: $.
    - name: pullrequestthreads-list
      description: Azure Repos List pull request threads
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-azure-repo.pullrequestthreads-list
      outputParameters:
      - type: object
        mapping: $.
    - name: pullrequestthreads-create
      description: Azure Repos Create a comment thread
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: microsoft-azure-repo.pullrequestthreads-create
      outputParameters:
      - type: object
        mapping: $.
    - name: pullrequestcommits-list
      description: Azure Repos List pull request commits
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: microsoft-azure-repo.pullrequestcommits-list
      outp

# --- truncated at 32 KB (40 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-azure-repo/refs/heads/main/capabilities/microsoft-azure-repo-capability.yaml