Verta VersioningService API

swagger: '2.0'
info:
  title: deployment/APISync.proto AuthzService VersioningService API
  version: version not set
basePath: /v1
consumes:
- application/json
produces:
- application/json
tags:
- name: VersioningService
paths:
  /versioning/commitMultipartVersionedBlobArtifact:
    post:
      operationId: VersioningService_commitMultipartVersionedBlobArtifact
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningCommitMultipartVersionedBlobArtifactResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: body
        in: body
        required: true
        schema:
          $ref: '#/definitions/versioningCommitMultipartVersionedBlobArtifact'
      tags:
      - VersioningService
  /versioning/commitVersionedBlobArtifactPart:
    post:
      operationId: VersioningService_commitVersionedBlobArtifactPart
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningCommitVersionedBlobArtifactPartResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: body
        in: body
        required: true
        schema:
          $ref: '#/definitions/versioningCommitVersionedBlobArtifactPart'
      tags:
      - VersioningService
  /versioning/getCommittedVersionedBlobArtifactParts:
    get:
      operationId: VersioningService_getCommittedVersionedBlobArtifactParts
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningGetCommittedVersionedBlobArtifactPartsResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.named_id.name
        in: query
        required: false
        type: string
      - name: repository_id.named_id.workspace_name
        in: query
        required: false
        type: string
      - name: repository_id.repo_id
        in: query
        required: false
        type: string
        format: uint64
      - name: commit_sha
        in: query
        required: false
        type: string
      - name: location
        in: query
        required: false
        type: array
        items:
          type: string
        collectionFormat: multi
      - name: path_dataset_component_blob_path
        in: query
        required: false
        type: string
      tags:
      - VersioningService
  /versioning/repositories:
    get:
      summary: CRUD for repositories
      operationId: VersioningService_ListRepositories2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningListRepositoriesRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: workspace_name
        in: query
        required: false
        type: string
      - name: pagination.page_number
        in: query
        required: false
        type: integer
        format: int32
      - name: pagination.page_limit
        in: query
        required: false
        type: integer
        format: int32
      tags:
      - VersioningService
  /versioning/repositories/{id.repo_id}:
    get:
      operationId: VersioningService_GetRepository2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningGetRepositoryRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: id.named_id.name
        in: query
        required: false
        type: string
      - name: id.named_id.workspace_name
        in: query
        required: false
        type: string
      tags:
      - VersioningService
    put:
      operationId: VersioningService_UpdateRepository2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningSetRepositoryResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: body
        in: body
        required: true
        schema:
          $ref: '#/definitions/versioningRepository'
      - name: id.named_id.name
        in: query
        required: false
        type: string
      - name: id.named_id.workspace_name
        in: query
        required: false
        type: string
      tags:
      - VersioningService
  /versioning/repositories/{repository_id.repo_id}:
    delete:
      operationId: VersioningService_DeleteRepository2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningDeleteRepositoryRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: repository_id.named_id.name
        in: query
        required: false
        type: string
      - name: repository_id.named_id.workspace_name
        in: query
        required: false
        type: string
      tags:
      - VersioningService
  /versioning/repositories/{repository_id.repo_id}/branches:
    get:
      summary: CRUD for Branches
      operationId: VersioningService_ListBranches2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningListBranchesRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: repository_id.named_id.name
        in: query
        required: false
        type: string
      - name: repository_id.named_id.workspace_name
        in: query
        required: false
        type: string
      tags:
      - VersioningService
  /versioning/repositories/{repository_id.repo_id}/branches/{branch}:
    get:
      operationId: VersioningService_GetBranch2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningGetBranchRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: branch
        in: path
        required: true
        type: string
      - name: repository_id.named_id.name
        in: query
        required: false
        type: string
      - name: repository_id.named_id.workspace_name
        in: query
        required: false
        type: string
      tags:
      - VersioningService
    delete:
      operationId: VersioningService_DeleteBranch2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningDeleteBranchRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: branch
        in: path
        required: true
        type: string
      - name: repository_id.named_id.name
        in: query
        required: false
        type: string
      - name: repository_id.named_id.workspace_name
        in: query
        required: false
        type: string
      tags:
      - VersioningService
    put:
      summary: Unlike tags, branches can be updated. The API must verify that the new commit is a child of the current branch.
      operationId: VersioningService_SetBranch2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningSetBranchRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: branch
        in: path
        required: true
        type: string
      - name: body
        in: body
        required: true
        schema:
          type: string
      - name: repository_id.named_id.name
        in: query
        required: false
        type: string
      - name: repository_id.named_id.workspace_name
        in: query
        required: false
        type: string
      tags:
      - VersioningService
  /versioning/repositories/{repository_id.repo_id}/branches/{branch}/log:
    get:
      operationId: VersioningService_ListCommitsLog2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningListCommitsLogRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: branch
        description: Pagination pagination = 2;
        in: path
        required: true
        type: string
      - name: repository_id.named_id.name
        in: query
        required: false
        type: string
      - name: repository_id.named_id.workspace_name
        in: query
        required: false
        type: string
      - name: commit_sha
        in: query
        required: false
        type: string
      tags:
      - VersioningService
  /versioning/repositories/{repository_id.repo_id}/commits:
    get:
      summary: CRUD for commits
      operationId: VersioningService_ListCommits2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningListCommitsRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: repository_id.named_id.name
        in: query
        required: false
        type: string
      - name: repository_id.named_id.workspace_name
        in: query
        required: false
        type: string
      - name: pagination.page_number
        in: query
        required: false
        type: integer
        format: int32
      - name: pagination.page_limit
        in: query
        required: false
        type: integer
        format: int32
      - name: commit_base
        in: query
        required: false
        type: string
      - name: commit_head
        in: query
        required: false
        type: string
      tags:
      - VersioningService
    post:
      operationId: VersioningService_CreateCommit2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningCreateCommitRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: body
        in: body
        required: true
        schema:
          $ref: '#/definitions/versioningCreateCommitRequest'
      tags:
      - VersioningService
  /versioning/repositories/{repository_id.repo_id}/commits/{commit_sha}:
    get:
      operationId: VersioningService_GetCommit2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningGetCommitRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: commit_sha
        in: path
        required: true
        type: string
      - name: repository_id.named_id.name
        in: query
        required: false
        type: string
      - name: repository_id.named_id.workspace_name
        in: query
        required: false
        type: string
      tags:
      - VersioningService
    delete:
      operationId: VersioningService_DeleteCommit2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningDeleteCommitRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: commit_sha
        in: path
        required: true
        type: string
      - name: repository_id.named_id.name
        in: query
        required: false
        type: string
      - name: repository_id.named_id.workspace_name
        in: query
        required: false
        type: string
      tags:
      - VersioningService
  /versioning/repositories/{repository_id.repo_id}/commits/{commit_sha}/blobs:
    get:
      summary: Getting blobs and folders in a commit
      operationId: VersioningService_ListCommitBlobs2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningListCommitBlobsRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: commit_sha
        description: Pagination pagination = 2;
        in: path
        required: true
        type: string
      - name: repository_id.named_id.name
        in: query
        required: false
        type: string
      - name: repository_id.named_id.workspace_name
        in: query
        required: false
        type: string
      - name: location_prefix
        description: 'List of folder names (with the last element potentially representing the blob name)

          This will be used to limit the search to scope just this location, like `git log /my/path` would do.'
        in: query
        required: false
        type: array
        items:
          type: string
        collectionFormat: multi
      tags:
      - VersioningService
  /versioning/repositories/{repository_id.repo_id}/commits/{commit_sha}/getUrlForBlobVersioned:
    post:
      operationId: VersioningService_getUrlForBlobVersioned2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningGetUrlForBlobVersionedResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: commit_sha
        in: path
        required: true
        type: string
      - name: body
        in: body
        required: true
        schema:
          $ref: '#/definitions/versioningGetUrlForBlobVersioned'
      tags:
      - VersioningService
  /versioning/repositories/{repository_id.repo_id}/commits/{commit_sha}/log:
    get:
      operationId: VersioningService_ListCommitsLog4
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningListCommitsLogRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: commit_sha
        in: path
        required: true
        type: string
      - name: repository_id.named_id.name
        in: query
        required: false
        type: string
      - name: repository_id.named_id.workspace_name
        in: query
        required: false
        type: string
      - name: branch
        description: Pagination pagination = 2;.
        in: query
        required: false
        type: string
      tags:
      - VersioningService
  /versioning/repositories/{repository_id.repo_id}/commits/{commit_sha}/path:
    get:
      operationId: VersioningService_GetCommitComponent2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningGetCommitComponentRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: commit_sha
        in: path
        required: true
        type: string
      - name: repository_id.named_id.name
        in: query
        required: false
        type: string
      - name: repository_id.named_id.workspace_name
        in: query
        required: false
        type: string
      - name: location
        description: 'List of folder names, with the last element being the name of the blob or tree

          the last element determines if the response to be returned is Folder or Blob

          Each element goes one level deeper. So ["foo", "bar"] represents the same as /foo/bar.'
        in: query
        required: false
        type: array
        items:
          type: string
        collectionFormat: multi
      tags:
      - VersioningService
  /versioning/repositories/{repository_id.repo_id}/commits/{commit_to_revert_sha}/revert:
    post:
      operationId: VersioningService_RevertRepositoryCommits2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningRevertRepositoryCommitsRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: commit_to_revert_sha
        in: path
        required: true
        type: string
      - name: body
        in: body
        required: true
        schema:
          $ref: '#/definitions/versioningRevertRepositoryCommitsRequest'
      tags:
      - VersioningService
  /versioning/repositories/{repository_id.repo_id}/diff:
    get:
      summary: Git-like operations
      operationId: VersioningService_ComputeRepositoryDiff2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningComputeRepositoryDiffRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: repository_id.named_id.name
        in: query
        required: false
        type: string
      - name: repository_id.named_id.workspace_name
        in: query
        required: false
        type: string
      - name: commit_a
        in: query
        required: false
        type: string
      - name: commit_b
        in: query
        required: false
        type: string
      - name: replace_a_with_common_ancestor
        description: Replace commit_a with the nearest common ancestor of commit_a and commit_b.
        in: query
        required: false
        type: boolean
      - name: branch_a
        description: for a or b only one of commit or branch should be populated.
        in: query
        required: false
        type: string
      - name: branch_b
        in: query
        required: false
        type: string
      tags:
      - VersioningService
  /versioning/repositories/{repository_id.repo_id}/merge:
    post:
      operationId: VersioningService_MergeRepositoryCommits2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningMergeRepositoryCommitsRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: body
        in: body
        required: true
        schema:
          $ref: '#/definitions/versioningMergeRepositoryCommitsRequest'
      tags:
      - VersioningService
  /versioning/repositories/{repository_id.repo_id}/tags:
    get:
      summary: CRUD for tags
      operationId: VersioningService_ListTags2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningListTagsRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: repository_id.named_id.name
        in: query
        required: false
        type: string
      - name: repository_id.named_id.workspace_name
        in: query
        required: false
        type: string
      tags:
      - VersioningService
  /versioning/repositories/{repository_id.repo_id}/tags/{tag}:
    get:
      operationId: VersioningService_GetTag2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningGetTagRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: tag
        in: path
        required: true
        type: string
      - name: repository_id.named_id.name
        in: query
        required: false
        type: string
      - name: repository_id.named_id.workspace_name
        in: query
        required: false
        type: string
      tags:
      - VersioningService
    delete:
      operationId: VersioningService_DeleteTag2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningDeleteTagRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: tag
        in: path
        required: true
        type: string
      - name: repository_id.named_id.name
        in: query
        required: false
        type: string
      - name: repository_id.named_id.workspace_name
        in: query
        required: false
        type: string
      tags:
      - VersioningService
    put:
      summary: Can't update a tag. If someone tries to set one that exists, we should error.
      operationId: VersioningService_SetTag2
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningSetTagRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.repo_id
        in: path
        required: true
        type: string
        format: uint64
      - name: tag
        in: path
        required: true
        type: string
      - name: body
        in: body
        required: true
        schema:
          type: string
      - name: repository_id.named_id.name
        in: query
        required: false
        type: string
      - name: repository_id.named_id.workspace_name
        in: query
        required: false
        type: string
      tags:
      - VersioningService
  /versioning/workspaces/{id.named_id.workspace_name}/repositories:
    post:
      operationId: VersioningService_CreateRepository
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningSetRepositoryResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: id.named_id.workspace_name
        in: path
        required: true
        type: string
      - name: body
        in: body
        required: true
        schema:
          $ref: '#/definitions/versioningRepository'
      - name: id.named_id.name
        in: query
        required: false
        type: string
      - name: id.repo_id
        in: query
        required: false
        type: string
        format: uint64
      tags:
      - VersioningService
  /versioning/workspaces/{id.named_id.workspace_name}/repositories/{id.named_id.name}:
    get:
      operationId: VersioningService_GetRepository
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningGetRepositoryRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: id.named_id.workspace_name
        in: path
        required: true
        type: string
      - name: id.named_id.name
        in: path
        required: true
        type: string
      - name: id.repo_id
        in: query
        required: false
        type: string
        format: uint64
      tags:
      - VersioningService
    put:
      operationId: VersioningService_UpdateRepository
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningSetRepositoryResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: id.named_id.workspace_name
        in: path
        required: true
        type: string
      - name: id.named_id.name
        in: path
        required: true
        type: string
      - name: body
        in: body
        required: true
        schema:
          $ref: '#/definitions/versioningRepository'
      - name: id.repo_id
        in: query
        required: false
        type: string
        format: uint64
      tags:
      - VersioningService
  /versioning/workspaces/{repository_id.named_id.workspace_name}/repositories/{repository_id.named_id.name}:
    delete:
      operationId: VersioningService_DeleteRepository
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningDeleteRepositoryRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.named_id.workspace_name
        in: path
        required: true
        type: string
      - name: repository_id.named_id.name
        in: path
        required: true
        type: string
      - name: repository_id.repo_id
        in: query
        required: false
        type: string
        format: uint64
      tags:
      - VersioningService
  /versioning/workspaces/{repository_id.named_id.workspace_name}/repositories/{repository_id.named_id.name}/branches:
    get:
      summary: CRUD for Branches
      operationId: VersioningService_ListBranches
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningListBranchesRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.named_id.workspace_name
        in: path
        required: true
        type: string
      - name: repository_id.named_id.name
        in: path
        required: true
        type: string
      - name: repository_id.repo_id
        in: query
        required: false
        type: string
        format: uint64
      tags:
      - VersioningService
  ? /versioning/workspaces/{repository_id.named_id.workspace_name}/repositories/{repository_id.named_id.name}/branches/{branch}
  : get:
      operationId: VersioningService_GetBranch
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningGetBranchRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.named_id.workspace_name
        in: path
        required: true
        type: string
      - name: repository_id.named_id.name
        in: path
        required: true
        type: string
      - name: branch
        in: path
        required: true
        type: string
      - name: repository_id.repo_id
        in: query
        required: false
        type: string
        format: uint64
      tags:
      - VersioningService
    delete:
      operationId: VersioningService_DeleteBranch
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningDeleteBranchRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.named_id.workspace_name
        in: path
        required: true
        type: string
      - name: repository_id.named_id.name
        in: path
        required: true
        type: string
      - name: branch
        in: path
        required: true
        type: string
      - name: repository_id.repo_id
        in: query
        required: false
        type: string
        format: uint64
      tags:
      - VersioningService
    put:
      summary: Unlike tags, branches can be updated. The API must verify that the new commit is a child of the current branch.
      operationId: VersioningService_SetBranch
      responses:
        '200':
          description: A successful response.
          schema:
            $ref: '#/definitions/versioningSetBranchRequestResponse'
        default:
          description: An unexpected error response.
          schema:
            $ref: '#/definitions/runtimeError'
      parameters:
      - name: repository_id.named_id.workspace_name
        in: path
        required: true
        type: string
      - name: repository_id.named_id.name
        in: path
        required

# --- truncated at 32 KB (80 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/verta/refs/heads/main/openapi/verta-versioningservice-api-openapi.yml