openapi: 3.1.0
info:
  title: Sonatype Nexus Repository REST Assets API
  description: 'Sonatype Nexus Repository Manager 3 exposes a REST API

    (under /service/rest/) for managing assets, components,

    repositories, blob stores, search, security, tasks, and

    related resources. The full OpenAPI document for a given

    instance is published at /service/rest/swagger.json.

    '
  version: v1
servers:
- url: '{nexus_url}/service/rest'
  description: Sonatype Nexus Repository instance base
  variables:
    nexus_url:
      default: https://nexus.example.com
      description: The base URL of your Nexus Repository Manager instance
security:
- basicAuth: []
- userToken: []
tags:
- name: Assets
paths:
  /v1/assets:
    get:
      summary: List assets in a repository
      operationId: listAssets
      tags:
      - Assets
      parameters:
      - in: query
        name: repository
        required: true
        schema:
          type: string
      - in: query
        name: continuationToken
        schema:
          type: string
      responses:
        '200':
          description: Page of assets
  /v1/assets/{id}:
    get:
      summary: Get an asset by ID
      operationId: getAsset
      tags:
      - Assets
      parameters:
      - in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Asset details
    delete:
      summary: Delete an asset by ID
      operationId: deleteAsset
      tags:
      - Assets
      parameters:
      - in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '204':
          description: Asset deleted
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: HTTP Basic authentication with a Nexus user account.
    userToken:
      type: http
      scheme: bearer
      description: 'Nexus user token authentication. Tokens can be generated

        per user when User Tokens are enabled on the instance.

        '