Cloudsmith repos API

openapi: 3.2.0
info:
  title: Cloudsmith API (v1) audit-log Repos API
  description: The API to the Cloudsmith Service
  termsOfService: https://help.cloudsmith.io
  contact:
    name: Cloudsmith Support
    url: https://help.cloudsmith.io
    email: support@cloudsmith.io
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  version: v1
servers:
- url: https://api.cloudsmith.io/
security:
- apikey: []
- basic: []
tags:
- name: repos
paths:
  /repos/:
    parameters: []
    get:
      operationId: repos_user_list
      summary: Get a list of all repositories associated with current user.
      description: Get a list of all repositories associated with current user.
      parameters:
      - name: page
        in: query
        description: A page number within the paginated result set.
        required: false
        schema:
          type: integer
      - name: page_size
        in: query
        description: Number of results to return per page.
        required: false
        schema:
          type: integer
      responses:
        '200':
          description: Retrieved the list of repositories
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Repository'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
      x-simplified: fields[repositories]=created_at,deleted_at,description,distributes,name,namespace,num_downloads,num_quarantined_packages,num_policy_violated_packages,open_source_license,open_source_project_url,package_count,package_group_count,repository_type_str,size,slug,slug_perm,storage_region
  /repos/{owner}/:
    parameters:
    - name: owner
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: repos_namespace_list
      summary: Get a list of all repositories within a namespace.
      description: Get a list of all repositories within a namespace.
      parameters:
      - name: page
        in: query
        description: A page number within the paginated result set.
        required: false
        schema:
          type: integer
      - name: page_size
        in: query
        description: Number of results to return per page.
        required: false
        schema:
          type: integer
      - name: query
        in: query
        description: 'A search term for querying repositories. Available options are: name, slug. Explicit filters: broadcast_state, repository_type.'
        required: false
        schema:
          type: string
          default: ''
      - name: sort
        in: query
        description: A field for sorting objects in ascending or descending order.
        required: false
        schema:
          type: string
          default: -created_at
      responses:
        '200':
          description: Retrieved the list of repositories
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Repository'
        '404':
          description: Owner namespace not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
      x-simplified: fields[repositories]=created_at,deleted_at,description,distributes,name,namespace,num_downloads,num_quarantined_packages,num_policy_violated_packages,open_source_license,open_source_project_url,package_count,package_group_count,repository_type_str,size,slug,slug_perm,storage_region
    post:
      operationId: repos_create
      summary: Create a new repository in a given namespace.
      description: Create a new repository in a given namespace.
      responses:
        '201':
          description: The repository was created.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepositoryCreate'
        '404':
          description: Owner namespace not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RepositoryCreateRequest'
  /repos/{owner}/{identifier}/:
    parameters:
    - name: owner
      in: path
      required: true
      schema:
        type: string
    - name: identifier
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: repos_read
      summary: Get a specific repository.
      description: Get a specific repository.
      responses:
        '200':
          description: Retrieved the specified repository
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Repository'
        '404':
          description: Owner namespace or repository not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
      x-simplified: fields[repositories]=created_at,deleted_at,description,distributes,name,namespace,num_downloads,num_quarantined_packages,num_policy_violated_packages,open_source_license,open_source_project_url,package_count,package_group_count,repository_type_str,size,slug,slug_perm,storage_region
    patch:
      operationId: repos_partial_update
      summary: Update details about a repository in a given namespace.
      description: Update details about a repository in a given namespace.
      responses:
        '200':
          description: The repository was updated.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Repository'
        '404':
          description: Unable to find repository with that name in the provided namespace.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RepositoryRequestPatch'
    delete:
      operationId: repos_delete
      description: Delete a repository in a given namespace.Repositories are soft-deleted and can be restored within a retention period. During this time, the repository's slug remains reserved and cannot be reused for new repositories.
      responses:
        '200':
          description: The repository has been scheduled for deletion.
        '404':
          description: Unable to find repository with that name in the provided namespace.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
  /repos/{owner}/{identifier}/ecdsa/:
    parameters:
    - name: owner
      in: path
      required: true
      schema:
        type: string
    - name: identifier
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: repos_ecdsa_list
      summary: Retrieve the active ECDSA key for the Repository.
      description: Retrieve the active ECDSA key for the Repository.
      responses:
        '200':
          description: Retrieved the active ECDSA key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepositoryEcdsaKey'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
    post:
      operationId: repos_ecdsa_create
      summary: Set the active ECDSA key for the Repository.
      description: Set the active ECDSA key for the Repository.
      responses:
        '200':
          description: The provided ECDSA key is the same as the current ECDSA key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepositoryEcdsaKey'
        '201':
          description: The provided ECDSA key was assigned to the Repository.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepositoryEcdsaKey'
        '400':
          description: The provided ECDSA key is not valid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '402':
          description: Custom ECDSA keys are not active; upgrade your account!
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '404':
          description: Organization/Repository does not exist, or you do not have permissions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RepositoryEcdsaKeyCreate'
  /repos/{owner}/{identifier}/ecdsa/regenerate/:
    parameters:
    - name: owner
      in: path
      required: true
      schema:
        type: string
    - name: identifier
      in: path
      required: true
      schema:
        type: string
    post:
      operationId: repos_ecdsa_regenerate
      summary: Regenerate ECDSA Key for the Repository.
      description: Regenerate ECDSA Key for the Repository.
      responses:
        '200':
          description: An ECDSA key was generated for the Repository.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepositoryEcdsaKey'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
  /repos/{owner}/{identifier}/geoip:
    parameters:
    - name: owner
      in: path
      required: true
      schema:
        type: string
    - name: identifier
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: repos_geoip_read
      summary: List all repository geoip rules.
      description: List all repository geoip rules.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepositoryGeoIpRules'
        '402':
          description: Geo/IP restrictions are not available; upgrade your account!
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '404':
          description: Owner namespace or repository not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
    put:
      operationId: repos_geoip_update
      summary: Replace repository geoip rules.
      description: Replace repository geoip rules.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepositoryGeoIpRules'
        '402':
          description: Geo/IP restrictions are not available; upgrade your account!
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '404':
          description: Owner namespace or repository not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RepositoryGeoIpRulesRequest'
    patch:
      operationId: repos_geoip_partial_update
      summary: Partially update repository geoip rules.
      description: Partially update repository geoip rules.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepositoryGeoIpRules'
        '402':
          description: Geo/IP restrictions are not available; upgrade your account!
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '404':
          description: Owner namespace or repository not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RepositoryGeoIpRulesRequestPatch'
  /repos/{owner}/{identifier}/geoip/disable/:
    parameters:
    - name: owner
      in: path
      required: true
      schema:
        type: string
    - name: identifier
      in: path
      required: true
      schema:
        type: string
    post:
      operationId: repos_geoip_disable
      summary: Disable GeoIP for this repository.
      description: Disable GeoIP for this repository.
      responses:
        '200':
          description: GeoIP has been disabled for this repository.
        '402':
          description: Geo/IP restrictions are not available; upgrade your account!
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '404':
          description: Owner namespace or repository not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RespositoryGeoIpEnableDisableRequest'
  /repos/{owner}/{identifier}/geoip/enable/:
    parameters:
    - name: owner
      in: path
      required: true
      schema:
        type: string
    - name: identifier
      in: path
      required: true
      schema:
        type: string
    post:
      operationId: repos_geoip_enable
      summary: Enable GeoIP for this repository.
      description: Enable GeoIP for this repository.
      responses:
        '200':
          description: GeoIP has been enabled for this repository.
        '402':
          description: Geo/IP restrictions are not available; upgrade your account!
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '404':
          description: Owner namespace or repository not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RespositoryGeoIpEnableDisableRequest'
  /repos/{owner}/{identifier}/geoip/status/:
    parameters:
    - name: owner
      in: path
      required: true
      schema:
        type: string
    - name: identifier
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: api_repos_geoip_status
      summary: Retrieve the GeoIP status for this repository.
      description: Retrieve the GeoIP status for this repository.
      responses:
        '200':
          description: Retrieved the GeoIP status for this repository.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepositoryGeoIpStatus'
        '402':
          description: Geo/IP restrictions are not available; upgrade your account!
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '404':
          description: Owner namespace or repository not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
  /repos/{owner}/{identifier}/geoip/test/:
    parameters:
    - name: owner
      in: path
      required: true
      schema:
        type: string
    - name: identifier
      in: path
      required: true
      schema:
        type: string
    post:
      operationId: repos_geoip_test
      summary: Test a list of IP addresses against the repository's current GeoIP rules.
      description: Test a list of IP addresses against the repository's current GeoIP rules.
      responses:
        '201':
          description: Successfuly tested addresses against the repository's GeoIP rules
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepositoryGeoIpTestAddressResponse'
        '402':
          description: Geo/IP restrictions are not available; upgrade your account!
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '404':
          description: Owner namespace or repository not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RepositoryGeoIpTestAddress'
  /repos/{owner}/{identifier}/gpg/:
    parameters:
    - name: owner
      in: path
      required: true
      schema:
        type: string
    - name: identifier
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: repos_gpg_list
      summary: Retrieve the active GPG key for the Repository.
      description: Retrieve the active GPG key for the Repository.
      responses:
        '200':
          description: Retrieved the active GPG key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepositoryGpgKey'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
    post:
      operationId: repos_gpg_create
      summary: Set the active GPG key for the Repository.
      description: Set the active GPG key for the Repository.
      responses:
        '200':
          description: The provided GPG key is the same as the current GPG key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepositoryGpgKey'
        '201':
          description: The provided GPG key was assigned to the Repository.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepositoryGpgKey'
        '400':
          description: The provided GPG key is not valid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '402':
          description: Custom GPG keys are not active; upgrade your account!
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '404':
          description: Organization/Repository does not exist, or you do not have permissions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RepositoryGpgKeyCreate'
  /repos/{owner}/{identifier}/gpg/regenerate/:
    parameters:
    - name: owner
      in: path
      required: true
      schema:
        type: string
    - name: identifier
      in: path
      required: true
      schema:
        type: string
    post:
      operationId: repos_gpg_regenerate
      summary: Regenerate GPG Key for the Repository.
      description: Regenerate GPG Key for the Repository.
      responses:
        '200':
          description: A GPG key was generated for the Repository.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepositoryGpgKey'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
  /repos/{owner}/{identifier}/privileges:
    parameters:
    - name: owner
      in: path
      required: true
      schema:
        type: string
    - name: identifier
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: repos_privileges_list
      summary: List all explicity created privileges for the repository.
      description: List all explicity created privileges for the repository.
      parameters:
      - name: page
        in: query
        description: A page number within the paginated result set.
        required: false
        schema:
          type: integer
      - name: page_size
        in: query
        description: Number of results to return per page.
        required: false
        schema:
          type: integer
      responses:
        '200':
          description: Retrieved privileges for the specified repository
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepositoryPrivilegeInput'
        '404':
          description: Owner namespace or repository not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
    put:
      operationId: repos_privileges_update
      summary: Replace all existing repository privileges with those specified.
      description: Replace all existing repository privileges with those specified.
      responses:
        '204':
          description: Repository privileges replaced
        '404':
          description: Owner namespace or repository not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RepositoryPrivilegeInputRequest'
    patch:
      operationId: repos_privileges_partial_update
      summary: Modify privileges for the repository.
      description: Modify privileges for the repository.
      responses:
        '204':
          description: Repository privileges updated
        '404':
          description: Owner namespace or repository not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RepositoryPrivilegeInputRequestPatch'
  /repos/{owner}/{identifier}/rsa/:
    parameters:
    - name: owner
      in: path
      required: true
      schema:
        type: string
    - name: identifier
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: repos_rsa_list
      summary: Retrieve the active RSA key for the Repository.
      description: Retrieve the active RSA key for the Repository.
      responses:
        '200':
          description: Retrieved the active RSA key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RepositoryRsaKey'
        '400':
          description: Request could not be processed (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
        '422':
          description: Missing or invalid parameters (see detail).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDetail'
      tags:
      - repos
    post:
      op

# --- truncated at 32 KB (540 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cloudsmith/refs/heads/main/openapi/cloudsmith-repos-api-openapi.yml