API Evangelist enhancements for the Nexus Repository Manager REST API

overlay: 1.0.0
info:
  title: API Evangelist enhancements for the Nexus Repository Manager REST API
  version: 1.0.0
  description: 'Adds the authentication schemes Sonatype documents (HTTP Basic, user tokens) and a templated server for self-hosted
    instances to the published OpenAPI, which declares neither. Sources: https://help.sonatype.com/en/authentication.html,
    https://help.sonatype.com/en/user-tokens.html, https://help.sonatype.com/en/automation.html.'
  x-provenance:
    generated: '2026-11-05'
    method: generated
    source:
    - https://help.sonatype.com/en/authentication.html
    - https://help.sonatype.com/en/user-tokens.html
    - https://help.sonatype.com/en/automation.html
extends: ../openapi/_original/nexus-openapi.json
actions:
- target: $.servers
  description: Add the templated self-hosted base URL documented in Automation (<nexus_url>/service/rest) beside the relative
    server.
  update:
    url: '{nexus_url}/service/rest'
    description: Any Nexus Repository instance; Sonatype's own public instance is https://repo.sonatype.com
    variables:
      nexus_url:
        default: https://repo.sonatype.com
        description: Base URL of the Nexus Repository instance
- target: $.components
  description: Declare the documented authentication schemes.
  update:
    securitySchemes:
      basicAuth:
        type: http
        scheme: basic
        description: HTTP Basic with a realm user (local, LDAP, SAML, Crowd). https://help.sonatype.com/en/authentication.html
      userToken:
        type: http
        scheme: basic
        description: User token name code / pass code sent as Basic credentials in place of username/password (Pro). https://help.sonatype.com/en/user-tokens.html
- target: $
  description: 'Default security requirement: Basic or user token.'
  update:
    security:
    - basicAuth: []
    - userToken: []
- target: $.info
  update:
    contact:
      name: Sonatype
      url: https://www.sonatype.com/products/sonatype-nexus-repository
    x-apievangelist:
      provider: nexus
      source_url: https://repo.sonatype.com/service/rest/swagger.json
      docs_published_copy: https://sonatype.github.io/sonatype-documentation/api/nexus-repository/latest/nexus-repository-api.json