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.
'