Sonatype Nexus Repository

Sonatype Nexus Repository Tags API

The Tags API from Sonatype Nexus Repository — 3 operation(s) for tags.

GitHub OpenAPI

Operations 7

POST /v1/tags/associate/{tagName} Associate components with a tag #
DELETE /v1/tags/associate/{tagName} Disassociate components from a tag #
GET /v1/tags List tags #
POST /v1/tags Create a tag #
GET /v1/tags/{name} Get a tag #
PUT /v1/tags/{name} Update a tags attributes #
DELETE /v1/tags/{name} Delete a tag #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/nexus/openapi/nexus-tags-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/nexus/json-schema/nexus-tag-xo-schema.json
📊
JSONSchema
https://artifacts.apis.io/nexus/json-schema/nexus-page-tag-xo-schema.json
📊
JSONSchema
https://artifacts.apis.io/nexus/json-schema/nexus-base-tag-xo-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/nexus:nexus-tags-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

nexus-tags-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Nexus Repository Manager REST Tags API
  version: 3.97.2-02
servers:
- url: /service/rest
tags:
- name: Tags
paths:
  /v1/tags/associate/{tagName}:
    post:
      tags:
      - Tags
      summary: Associate components with a tag
      operationId: createTagsAssociate
      parameters:
      - name: tagName
        in: path
        description: Tag to associate to the matched components
        required: true
        schema:
          type: string
      - name: wait
        in: query
        description: The query waits until the indexing is complete
        schema:
          type: boolean
          default: true
      - name: q
        in: query
        description: Query by keyword
        schema:
          type: string
      - name: repository
        in: query
        description: Repository name
        schema:
          type: string
      - name: repositoryName
        in: query
        description: Repository name
        schema:
          type: string
      - name: format
        in: query
        description: Query by format
        schema:
          type: string
      - name: group
        in: query
        description: Component group
        schema:
          type: string
      - name: name
        in: query
        description: Component name
        schema:
          type: string
      - name: version
        in: query
        description: Component version
        schema:
          type: string
      - name: prerelease
        in: query
        description: Prerelease version flag
        schema:
          type: string
      - name: last_updated
        in: query
        description: Asset last modified time
        schema:
          type: string
      - name: lastBlobUpdated
        in: query
        description: Asset last modified time (UI)
        schema:
          type: string
      - name: md5
        in: query
        description: Specific MD5 hash of component's asset
        schema:
          type: string
      - name: sha1
        in: query
        description: Specific SHA-1 hash of component's asset
        schema:
          type: string
      - name: sha256
        in: query
        description: Specific SHA-256 hash of component's asset
        schema:
          type: string
      - name: sha512
        in: query
        description: Specific SHA-512 hash of component's asset
        schema:
          type: string
      - name: ansible-galaxy.namespace
        in: query
        description: ansible-galaxy namespace
        schema:
          type: string
      - name: ansible-galaxy.name
        in: query
        description: ansible-galaxy name
        schema:
          type: string
      - name: ansible-galaxy.version
        in: query
        description: ansible-galaxy version
        schema:
          type: string
      - name: composer.vendor
        in: query
        description: Vendor
        schema:
          type: string
      - name: composer.package
        in: query
        description: Package
        schema:
          type: string
      - name: composer.version
        in: query
        description: Version
        schema:
          type: string
      - name: composer.description
        in: query
        description: Composer Description
        schema:
          type: string
      - name: composer.keywords
        in: query
        description: Composer Keywords
        schema:
          type: string
      - name: conan.baseVersion
        in: query
        description: Conan base version
        schema:
          type: string
      - name: conan.channel
        in: query
        description: Conan channel
        schema:
          type: string
      - name: conan.revision
        in: query
        description: Conan recipe revision
        schema:
          type: string
      - name: conan.packageId
        in: query
        description: Conan package id
        schema:
          type: string
      - name: conan.packageRevision
        in: query
        description: Conan package revision
        schema:
          type: string
      - name: docker.imageName
        in: query
        description: Docker image name
        schema:
          type: string
      - name: docker.imageTag
        in: query
        description: Docker image tag
        schema:
          type: string
      - name: docker.layerId
        in: query
        description: Docker layer ID
        schema:
          type: string
      - name: docker.contentDigest
        in: query
        description: Docker content digest
        schema:
          type: string
      - name: docker.os
        in: query
        description: Docker image OS
        schema:
          type: string
      - name: docker.architecture
        in: query
        description: Docker image architecture
        schema:
          type: string
      - name: docker.labels
        in: query
        description: Docker image labels
        schema:
          type: string
      - name: docker.author
        in: query
        description: Docker image author
        schema:
          type: string
      - name: maven.groupId
        in: query
        description: Maven groupId
        schema:
          type: string
      - name: maven.artifactId
        in: query
        description: Maven artifactId
        schema:
          type: string
      - name: maven.baseVersion
        in: query
        description: Maven base version
        schema:
          type: string
      - name: maven.extension
        in: query
        description: Maven extension of component's asset
        schema:
          type: string
      - name: maven.classifier
        in: query
        description: Maven classifier of component's asset
        schema:
          type: string
      - name: gavec
        in: query
        description: Group asset version extension classifier
        schema:
          type: string
      - name: npm.scope
        in: query
        description: npm scope
        schema:
          type: string
      - name: npm.author
        in: query
        description: npm author
        schema:
          type: string
      - name: npm.description
        in: query
        description: npm description
        schema:
          type: string
      - name: npm.keywords
        in: query
        description: npm keywords
        schema:
          type: string
      - name: npm.license
        in: query
        description: npm license
        schema:
          type: string
      - name: npm.tagged_is
        in: query
        description: npm tagged is
        schema:
          type: string
      - name: npm.tagged_not
        in: query
        description: npm tagged not
        schema:
          type: string
      - name: nuget.id
        in: query
        description: NuGet id
        schema:
          type: string
      - name: nuget.tags
        in: query
        description: NuGet tags
        schema:
          type: string
      - name: nuget.title
        in: query
        description: NuGet title
        schema:
          type: string
      - name: nuget.authors
        in: query
        description: NuGet authors
        schema:
          type: string
      - name: nuget.description
        in: query
        description: NuGet description
        schema:
          type: string
      - name: nuget.summary
        in: query
        description: NuGet summary
        schema:
          type: string
      - name: nuget.is_prerelease
        in: query
        description: NuGet prerelease
        schema:
          type: string
      - name: oci.imageName
        in: query
        description: OCI image name
        schema:
          type: string
      - name: oci.imageTag
        in: query
        description: OCI image tag
        schema:
          type: string
      - name: oci.contentDigest
        in: query
        description: OCI content digest
        schema:
          type: string
      - name: p2.pluginName
        in: query
        description: p2 plugin name
        schema:
          type: string
      - name: pub.asset_kind
        in: query
        description: Pub asset kind (PACKAGE, PACKAGE_METADATA, VERSION_METADATA, ADVISORIES)
        schema:
          type: string
      - name: pypi.classifiers
        in: query
        description: PyPI classifiers
        schema:
          type: string
      - name: pypi.description
        in: query
        description: PyPI description
        schema:
          type: string
      - name: pypi.keywords
        in: query
        description: PyPI keywords
        schema:
          type: string
      - name: pypi.summary
        in: query
        description: PyPI summary
        schema:
          type: string
      - name: raw.name
        in: query
        description: Raw asset filename (basename)
        schema:
          type: string
      - name: rubygems.description
        in: query
        description: RubyGems description
        schema:
          type: string
      - name: rubygems.platform
        in: query
        description: RubyGems platform
        schema:
          type: string
      - name: rubygems.summary
        in: query
        description: RubyGems summary
        schema:
          type: string
      - name: swift.scope
        in: query
        description: swift scope
        schema:
          type: string
      - name: swift.asset_kind
        in: query
        description: swift asset kind
        schema:
          type: string
      - name: tag
        in: query
        description: Component tag
        schema:
          type: string
      - name: terraform.provider
        in: query
        description: terraform provider
        schema:
          type: string
      - name: terraform.namespace
        in: query
        description: terraform namespace
        schema:
          type: string
      - name: terraform.name
        in: query
        description: terraform name
        schema:
          type: string
      - name: yum.architecture
        in: query
        description: Yum architecture
        schema:
          type: string
      - name: yum.name
        in: query
        description: Yum package name
        schema:
          type: string
      responses:
        '200':
          description: Associate was successful
        '404':
          description: Tag or components not found
    delete:
      tags:
      - Tags
      summary: Disassociate components from a tag
      operationId: deleteTagsAssociate
      parameters:
      - name: tagName
        in: path
        description: Tag to associate to the matched components
        required: true
        schema:
          type: string
      - name: wait
        in: query
        description: The query waits until the indexing is complete
        schema:
          type: boolean
          default: true
      - name: q
        in: query
        description: Query by keyword
        schema:
          type: string
      - name: repository
        in: query
        description: Repository name
        schema:
          type: string
      - name: repositoryName
        in: query
        description: Repository name
        schema:
          type: string
      - name: format
        in: query
        description: Query by format
        schema:
          type: string
      - name: group
        in: query
        description: Component group
        schema:
          type: string
      - name: name
        in: query
        description: Component name
        schema:
          type: string
      - name: version
        in: query
        description: Component version
        schema:
          type: string
      - name: prerelease
        in: query
        description: Prerelease version flag
        schema:
          type: string
      - name: last_updated
        in: query
        description: Asset last modified time
        schema:
          type: string
      - name: lastBlobUpdated
        in: query
        description: Asset last modified time (UI)
        schema:
          type: string
      - name: md5
        in: query
        description: Specific MD5 hash of component's asset
        schema:
          type: string
      - name: sha1
        in: query
        description: Specific SHA-1 hash of component's asset
        schema:
          type: string
      - name: sha256
        in: query
        description: Specific SHA-256 hash of component's asset
        schema:
          type: string
      - name: sha512
        in: query
        description: Specific SHA-512 hash of component's asset
        schema:
          type: string
      - name: ansible-galaxy.namespace
        in: query
        description: ansible-galaxy namespace
        schema:
          type: string
      - name: ansible-galaxy.name
        in: query
        description: ansible-galaxy name
        schema:
          type: string
      - name: ansible-galaxy.version
        in: query
        description: ansible-galaxy version
        schema:
          type: string
      - name: composer.vendor
        in: query
        description: Vendor
        schema:
          type: string
      - name: composer.package
        in: query
        description: Package
        schema:
          type: string
      - name: composer.version
        in: query
        description: Version
        schema:
          type: string
      - name: composer.description
        in: query
        description: Composer Description
        schema:
          type: string
      - name: composer.keywords
        in: query
        description: Composer Keywords
        schema:
          type: string
      - name: conan.baseVersion
        in: query
        description: Conan base version
        schema:
          type: string
      - name: conan.channel
        in: query
        description: Conan channel
        schema:
          type: string
      - name: conan.revision
        in: query
        description: Conan recipe revision
        schema:
          type: string
      - name: conan.packageId
        in: query
        description: Conan package id
        schema:
          type: string
      - name: conan.packageRevision
        in: query
        description: Conan package revision
        schema:
          type: string
      - name: docker.imageName
        in: query
        description: Docker image name
        schema:
          type: string
      - name: docker.imageTag
        in: query
        description: Docker image tag
        schema:
          type: string
      - name: docker.layerId
        in: query
        description: Docker layer ID
        schema:
          type: string
      - name: docker.contentDigest
        in: query
        description: Docker content digest
        schema:
          type: string
      - name: docker.os
        in: query
        description: Docker image OS
        schema:
          type: string
      - name: docker.architecture
        in: query
        description: Docker image architecture
        schema:
          type: string
      - name: docker.labels
        in: query
        description: Docker image labels
        schema:
          type: string
      - name: docker.author
        in: query
        description: Docker image author
        schema:
          type: string
      - name: maven.groupId
        in: query
        description: Maven groupId
        schema:
          type: string
      - name: maven.artifactId
        in: query
        description: Maven artifactId
        schema:
          type: string
      - name: maven.baseVersion
        in: query
        description: Maven base version
        schema:
          type: string
      - name: maven.extension
        in: query
        description: Maven extension of component's asset
        schema:
          type: string
      - name: maven.classifier
        in: query
        description: Maven classifier of component's asset
        schema:
          type: string
      - name: gavec
        in: query
        description: Group asset version extension classifier
        schema:
          type: string
      - name: npm.scope
        in: query
        description: npm scope
        schema:
          type: string
      - name: npm.author
        in: query
        description: npm author
        schema:
          type: string
      - name: npm.description
        in: query
        description: npm description
        schema:
          type: string
      - name: npm.keywords
        in: query
        description: npm keywords
        schema:
          type: string
      - name: npm.license
        in: query
        description: npm license
        schema:
          type: string
      - name: npm.tagged_is
        in: query
        description: npm tagged is
        schema:
          type: string
      - name: npm.tagged_not
        in: query
        description: npm tagged not
        schema:
          type: string
      - name: nuget.id
        in: query
        description: NuGet id
        schema:
          type: string
      - name: nuget.tags
        in: query
        description: NuGet tags
        schema:
          type: string
      - name: nuget.title
        in: query
        description: NuGet title
        schema:
          type: string
      - name: nuget.authors
        in: query
        description: NuGet authors
        schema:
          type: string
      - name: nuget.description
        in: query
        description: NuGet description
        schema:
          type: string
      - name: nuget.summary
        in: query
        description: NuGet summary
        schema:
          type: string
      - name: nuget.is_prerelease
        in: query
        description: NuGet prerelease
        schema:
          type: string
      - name: oci.imageName
        in: query
        description: OCI image name
        schema:
          type: string
      - name: oci.imageTag
        in: query
        description: OCI image tag
        schema:
          type: string
      - name: oci.contentDigest
        in: query
        description: OCI content digest
        schema:
          type: string
      - name: p2.pluginName
        in: query
        description: p2 plugin name
        schema:
          type: string
      - name: pub.asset_kind
        in: query
        description: Pub asset kind (PACKAGE, PACKAGE_METADATA, VERSION_METADATA, ADVISORIES)
        schema:
          type: string
      - name: pypi.classifiers
        in: query
        description: PyPI classifiers
        schema:
          type: string
      - name: pypi.description
        in: query
        description: PyPI description
        schema:
          type: string
      - name: pypi.keywords
        in: query
        description: PyPI keywords
        schema:
          type: string
      - name: pypi.summary
        in: query
        description: PyPI summary
        schema:
          type: string
      - name: raw.name
        in: query
        description: Raw asset filename (basename)
        schema:
          type: string
      - name: rubygems.description
        in: query
        description: RubyGems description
        schema:
          type: string
      - name: rubygems.platform
        in: query
        description: RubyGems platform
        schema:
          type: string
      - name: rubygems.summary
        in: query
        description: RubyGems summary
        schema:
          type: string
      - name: swift.scope
        in: query
        description: swift scope
        schema:
          type: string
      - name: swift.asset_kind
        in: query
        description: swift asset kind
        schema:
          type: string
      - name: tag
        in: query
        description: Component tag
        schema:
          type: string
      - name: terraform.provider
        in: query
        description: terraform provider
        schema:
          type: string
      - name: terraform.namespace
        in: query
        description: terraform namespace
        schema:
          type: string
      - name: terraform.name
        in: query
        description: terraform name
        schema:
          type: string
      - name: yum.architecture
        in: query
        description: Yum architecture
        schema:
          type: string
      - name: yum.name
        in: query
        description: Yum package name
        schema:
          type: string
      responses:
        '200':
          description: Disassociation was successful
        '404':
          description: Tag or components not found
  /v1/tags:
    get:
      tags:
      - Tags
      summary: List tags
      operationId: listTags
      parameters:
      - name: continuationToken
        in: query
        description: A token returned by a prior request. If present, the next page of results are returned
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PageTagXO'
    post:
      tags:
      - Tags
      summary: Create a tag
      operationId: createTags
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TagXO'
        required: true
      responses:
        '200':
          description: Tag was added
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TagXO'
        '400':
          description: Bad request. Check tag name and attributes. Name can only contain letters, numbers, underscores, hyphens and dots and cannot start with an underscore or dot. The name cannot exceed 256 characters. The attributes is a JSON document which cannot exceed 20k.
  /v1/tags/{name}:
    get:
      tags:
      - Tags
      summary: Get a tag
      operationId: getTags
      parameters:
      - name: name
        in: path
        description: Name of the tag to retrieve
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Tag returned
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TagXO'
        '404':
          description: Tag not found
    put:
      tags:
      - Tags
      summary: Update a tags attributes
      operationId: updateTags
      parameters:
      - name: name
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BaseTagXO'
        required: true
      responses:
        '200':
          description: Tag updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TagXO'
        '404':
          description: Tag not found
        '400':
          description: Bad request. Check tag attributes. The attributes is a JSON document which cannot exceed 20k
    delete:
      tags:
      - Tags
      summary: Delete a tag
      operationId: deleteTags
      parameters:
      - name: name
        in: path
        description: Name of the tag to delete
        required: true
        schema:
          type: string
      responses:
        '204':
          description: Tag was deleted
        '404':
          description: Tag not found
components:
  schemas:
    PageTagXO:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/TagXO'
        continuationToken:
          type: string
        total:
          type: integer
          format: int64
    TagXO:
      required:
      - name
      type: object
      properties:
        name:
          maxLength: 256
          minLength: 1
          pattern: ^[a-zA-Z0-9\-]{1}[a-zA-Z0-9_\-\.]*$
          type: string
        attributes:
          type: object
          additionalProperties: true
        firstCreated:
          type: string
          format: date-time
        lastUpdated:
          type: string
          format: date-time
    BaseTagXO:
      type: object
      properties:
        attributes:
          type: object
          additionalProperties: true