Sonatype Nexus Repository Management API

The Repository Management API from Sonatype Nexus — 108 operation(s) for repository management.

OpenAPI Specification

sonatype-nexus-repository-management-api-openapi.yml Raw ↑
openapi: 3.0.1
info:
  contact:
    name: Sonatype Community Maintainers
    url: https://github.com/sonatype-nexus-community
  description: This documents the available APIs into [Sonatype Nexus Repository Manager](https://www.sonatype.com/products/sonatype-nexus-repository) as of version 3.91.0-07.
  license:
    name: Apache-2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
  title: Sonatype Nexus Repository Manager assets Repository Management API
  version: 3.91.0-07
servers:
- url: /service/rest/
security:
- BasicAuth: []
tags:
- name: Repository Management
paths:
  /v1/repositories:
    get:
      operationId: getAllRepositories
      responses:
        '200':
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/RepositoryXO'
                type: array
          description: successful operation
      summary: List repositories
      tags:
      - Repository Management
  /v1/repositories/apt/hosted:
    post:
      operationId: createAptHostedRepository
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AptHostedRepositoryApiRequest'
        required: false
      responses:
        '201':
          content: {}
          description: Repository created
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
        '405':
          content: {}
          description: Feature is disabled in High Availability
      summary: Create APT hosted repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/apt/hosted/{repositoryName}:
    get:
      operationId: getAptHostedRepository
      parameters:
      - in: path
        name: repositoryName
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AptHostedApiRepository'
          description: successful operation
      summary: Get repository
      tags:
      - Repository Management
    put:
      operationId: updateAptHostedRepository
      parameters:
      - description: Name of the repository to update
        in: path
        name: repositoryName
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AptHostedRepositoryApiRequest'
        required: false
      responses:
        '204':
          content: {}
          description: Repository updated
        '400':
          content: {}
          description: Bad request
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
        '404':
          content: {}
          description: Repository not found
      summary: Update APT hosted repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/apt/proxy:
    post:
      operationId: createAptProxyRepository
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AptProxyRepositoryApiRequest'
        required: false
      responses:
        '201':
          content: {}
          description: Repository created
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
        '405':
          content: {}
          description: Feature is disabled in High Availability
      summary: Create APT proxy repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/apt/proxy/{repositoryName}:
    get:
      operationId: getAptProxyRepository
      parameters:
      - in: path
        name: repositoryName
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AptProxyApiRepository'
          description: successful operation
      summary: Get repository
      tags:
      - Repository Management
    put:
      operationId: updateAptProxyRepository
      parameters:
      - description: Name of the repository to update
        in: path
        name: repositoryName
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AptProxyRepositoryApiRequest'
        required: false
      responses:
        '204':
          content: {}
          description: Repository updated
        '400':
          content: {}
          description: Bad request
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
        '404':
          content: {}
          description: Repository not found
      summary: Update APT proxy repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/cargo/group:
    post:
      operationId: createCargoGroupRepository
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CargoGroupRepositoryApiRequest'
        required: false
      responses:
        '201':
          content: {}
          description: Repository created
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
      summary: Create cargo group repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/cargo/group/{repositoryName}:
    get:
      operationId: getCargoGroupRepository
      parameters:
      - in: path
        name: repositoryName
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CargoGroupApiRepository'
          description: successful operation
      summary: Get repository
      tags:
      - Repository Management
    put:
      operationId: updateCargoGroupRepository
      parameters:
      - description: Name of the repository to update
        in: path
        name: repositoryName
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CargoGroupRepositoryApiRequest'
        required: false
      responses:
        '204':
          content: {}
          description: Repository updated
        '400':
          content: {}
          description: Bad request
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
      summary: Update cargo group repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/cargo/hosted:
    post:
      operationId: createCargoHostedRepository
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CargoHostedRepositoryApiRequest'
        required: false
      responses:
        '201':
          content: {}
          description: Repository created
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
      summary: Create cargo hosted repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/cargo/hosted/{repositoryName}:
    get:
      operationId: getCargoHostedRepository
      parameters:
      - in: path
        name: repositoryName
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SimpleApiHostedRepository'
          description: successful operation
      summary: Get repository
      tags:
      - Repository Management
    put:
      operationId: updateCargoHostedRepository
      parameters:
      - description: Name of the repository to update
        in: path
        name: repositoryName
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CargoHostedRepositoryApiRequest'
        required: false
      responses:
        '204':
          content: {}
          description: Repository updated
        '400':
          content: {}
          description: Bad request
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
      summary: Update cargo hosted repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/cargo/proxy:
    post:
      operationId: createCargoProxyRepository
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CargoProxyRepositoryApiRequest'
        required: false
      responses:
        '201':
          content: {}
          description: Repository created
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
      summary: Create cargo proxy repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/cargo/proxy/{repositoryName}:
    get:
      operationId: getCargoProxyRepository
      parameters:
      - in: path
        name: repositoryName
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CargoProxyApiRepository'
          description: successful operation
      summary: Get repository
      tags:
      - Repository Management
    put:
      operationId: updateCargoProxyRepository
      parameters:
      - description: Name of the repository to update
        in: path
        name: repositoryName
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CargoProxyRepositoryApiRequest'
        required: false
      responses:
        '204':
          content: {}
          description: Repository updated
        '400':
          content: {}
          description: Bad request
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
      summary: Update cargo proxy repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/cocoapods/proxy:
    post:
      operationId: createCocoapodsProxyRepository
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CocoapodsProxyRepositoryApiRequest'
        required: false
      responses:
        '201':
          content: {}
          description: Repository created
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
        '405':
          content: {}
          description: Feature is disabled in High Availability
      summary: Create Cocoapods proxy repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/cocoapods/proxy/{repositoryName}:
    get:
      operationId: getCocoapodsProxyRepository
      parameters:
      - in: path
        name: repositoryName
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SimpleApiProxyRepository'
          description: successful operation
      summary: Get repository
      tags:
      - Repository Management
    put:
      operationId: updateCocoapodsProxyRepository
      parameters:
      - description: Name of the repository to update
        in: path
        name: repositoryName
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CocoapodsProxyRepositoryApiRequest'
        required: false
      responses:
        '204':
          content: {}
          description: Repository updated
        '400':
          content: {}
          description: Bad request
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
      summary: Update Cocoapods proxy repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/composer/proxy:
    post:
      operationId: createComposerProxyRepository
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ComposerProxyRepositoryApiRequest'
        required: false
      responses:
        '201':
          content: {}
          description: Repository created
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
      summary: Create composer proxy repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/composer/proxy/{repositoryName}:
    get:
      operationId: getComposerProxyRepository
      parameters:
      - in: path
        name: repositoryName
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SimpleApiProxyRepository'
          description: successful operation
      summary: Get repository
      tags:
      - Repository Management
    put:
      operationId: updateComposerProxyRepository
      parameters:
      - description: Name of the repository to update
        in: path
        name: repositoryName
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ComposerProxyRepositoryApiRequest'
        required: false
      responses:
        '204':
          content: {}
          description: Repository updated
        '400':
          content: {}
          description: Bad request
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
      summary: Update composer proxy repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/conan/group:
    post:
      operationId: createConanGroupRepository
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConanGroupRepositoryApiRequest'
        required: false
      responses:
        '201':
          content: {}
          description: Repository created
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
      summary: Create Conan group repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/conan/group/{repositoryName}:
    get:
      operationId: getConanGroupRepository
      parameters:
      - in: path
        name: repositoryName
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SimpleApiGroupDeployRepository'
          description: successful operation
      summary: Get repository
      tags:
      - Repository Management
    put:
      operationId: updateConanGroupRepository
      parameters:
      - description: Name of the repository to update
        in: path
        name: repositoryName
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConanGroupRepositoryApiRequest'
        required: false
      responses:
        '204':
          content: {}
          description: Repository updated
        '400':
          content: {}
          description: Bad request
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
      summary: Update Conan group repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/conan/hosted:
    post:
      operationId: createConanHostedRepository
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConanHostedRepositoryApiRequest'
        required: false
      responses:
        '201':
          content: {}
          description: Repository created
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
      summary: Create Conan hosted repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/conan/hosted/{repositoryName}:
    get:
      operationId: getConanHostedRepository
      parameters:
      - in: path
        name: repositoryName
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SimpleApiHostedRepository'
          description: successful operation
      summary: Get repository
      tags:
      - Repository Management
    put:
      operationId: updateConanHostedRepository
      parameters:
      - description: Name of the repository to update
        in: path
        name: repositoryName
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConanHostedRepositoryApiRequest'
        required: false
      responses:
        '204':
          content: {}
          description: Repository updated
        '400':
          content: {}
          description: Bad request
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
        '404':
          content: {}
          description: Repository not found
      summary: Update Conan hosted repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/conan/proxy:
    post:
      operationId: createConanProxyRepository
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConanProxyRepositoryApiRequest'
        required: false
      responses:
        '201':
          content: {}
          description: Repository created
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
        '405':
          content: {}
          description: Feature is disabled in High Availability
      summary: Create Conan proxy repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/conan/proxy/{repositoryName}:
    get:
      operationId: getConanProxyRepository
      parameters:
      - in: path
        name: repositoryName
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConanProxyApiRepository'
          description: successful operation
      summary: Get repository
      tags:
      - Repository Management
    put:
      operationId: updateConanProxyRepository
      parameters:
      - description: Name of the repository to update
        in: path
        name: repositoryName
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ConanProxyRepositoryApiRequest'
        required: false
      responses:
        '204':
          content: {}
          description: Repository updated
        '400':
          content: {}
          description: Bad request
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
        '404':
          content: {}
          description: Repository not found
      summary: Update Conan proxy repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/conda/proxy:
    post:
      operationId: createCondaProxyRepository
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CondaProxyRepositoryApiRequest'
        required: false
      responses:
        '201':
          content: {}
          description: Repository created
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
        '405':
          content: {}
          description: Feature is disabled in High Availability
      summary: Create conda proxy repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/conda/proxy/{repositoryName}:
    get:
      operationId: getCondaProxyRepository
      parameters:
      - in: path
        name: repositoryName
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SimpleApiProxyRepository'
          description: successful operation
      summary: Get repository
      tags:
      - Repository Management
    put:
      operationId: updateCondaProxyRepository
      parameters:
      - description: Name of the repository to update
        in: path
        name: repositoryName
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CondaProxyRepositoryApiRequest'
        required: false
      responses:
        '204':
          content: {}
          description: Repository updated
        '400':
          content: {}
          description: Bad request
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
      summary: Update conda proxy repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/docker/group:
    post:
      operationId: createDockerGroupRepository
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DockerGroupRepositoryApiRequest'
        required: false
      responses:
        '201':
          content: {}
          description: Repository created
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
      summary: Create Docker group repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/docker/group/{repositoryName}:
    get:
      operationId: getDockerGroupRepository
      parameters:
      - in: path
        name: repositoryName
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DockerGroupApiRepository'
          description: successful operation
      summary: Get repository
      tags:
      - Repository Management
    put:
      operationId: updateDockerGroupRepository
      parameters:
      - description: Name of the repository to update
        in: path
        name: repositoryName
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DockerGroupRepositoryApiRequest'
        required: false
      responses:
        '204':
          content: {}
          description: Repository updated
        '400':
          content: {}
          description: Bad request
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
        '404':
          content: {}
          description: Repository not found
      summary: Update Docker group repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/docker/hosted:
    post:
      operationId: createDockerHostedRepository
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DockerHostedRepositoryApiRequest'
        required: false
      responses:
        '201':
          content: {}
          description: Repository created
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Repository not found
      summary: Create Docker hosted repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/docker/hosted/{repositoryName}:
    get:
      operationId: getDockerHostedRepository
      parameters:
      - in: path
        name: repositoryName
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DockerHostedApiRepository'
          description: successful operation
      summary: Get repository
      tags:
      - Repository Management
    put:
      operationId: updateDockerHostedRepository
      parameters:
      - description: Name of the repository to update
        in: path
        name: repositoryName
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DockerHostedRepositoryApiRequest'
        required: false
      responses:
        '204':
          content: {}
          description: Repository updated
        '400':
          content: {}
          description: Bad request
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
        '404':
          content: {}
          description: Repository not found
      summary: Update Docker hosted repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/docker/proxy:
    post:
      operationId: createDockerProxyRepository
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DockerProxyRepositoryApiRequest'
        required: false
      responses:
        '201':
          content: {}
          description: Repository created
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
      summary: Create Docker proxy repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/docker/proxy/{repositoryName}:
    get:
      operationId: getDockerProxyRepository
      parameters:
      - in: path
        name: repositoryName
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DockerProxyApiRepository'
          description: successful operation
      summary: Get repository
      tags:
      - Repository Management
    put:
      operationId: updateDockerProxyRepository
      parameters:
      - description: Name of the repository to update
        in: path
        name: repositoryName
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DockerProxyRepositoryApiRequest'
        required: false
      responses:
        '204':
          content: {}
          description: Repository updated
        '400':
          content: {}
          description: Bad request
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
        '404':
          content: {}
          description: Repository not found
      summary: Update Docker proxy repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/gitlfs/hosted:
    post:
      operationId: createGitlfsHostedRepository
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GitLfsHostedRepositoryApiRequest'
        required: false
      responses:
        '201':
          content: {}
          description: Repository created
        '401':
          content: {}
          description: Authentication required
        '403':
          content: {}
          description: Insufficient permissions
      summary: Create Git LFS hosted repository
      tags:
      - Repository Management
      x-codegen-request-body-name: body
  /v1/repositories/gitlfs/hosted/{repositoryName}:
    get:
      operationId: getGitlfsHostedRepository
      parameters:
      - in: path
        name: repositoryName
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SimpleApiHostedRepository'
          description: successful operation
      summary: Get repository
      tags:
      - Repository Management
    put:
      operationId: updateGitlfsHostedRepository
      parameters:
      - description: Name of the repository to update
        in: path
        name: repositoryName
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GitLfsHostedRepositoryApiRequest'
        required: false
      responses:
        '204':
          content: {}
          description: Repository updated
        '400':
          content: {}
          description: Bad request
        '401':

# --- truncated at 32 KB (204 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/sonatype-nexus/refs/heads/main/openapi/sonatype-nexus-repository-management-api-openapi.yml