swagger: '2.0'
info:
  title: GitLab access_requests ci_catalog API
  version: v4
  description: Operations related to access requests
host: gitlab.com
produces:
- application/json
tags:
- name: ci_catalog
  description: Operations about ci_catalogs
paths:
  /api/v4/projects/{id}/catalog/publish:
    post:
      summary: Publish a new component project release as version to the CI/CD catalog
      description: Publishes a release of a catalog resource as version to the CI/CD catalog.
      produces:
      - application/json
      consumes:
      - application/json
      parameters:
      - in: path
        name: id
        description: The ID or URL-encoded path of the project
        type: string
        required: true
      - name: postApiV4ProjectsIdCatalogPublish
        in: body
        required: true
        schema:
          $ref: '#/definitions/postApiV4ProjectsIdCatalogPublish'
      responses:
        '201':
          description: Publish a new component project release as version to the CI/CD catalog
          schema:
            $ref: '#/definitions/API_Entities_Ci_Catalog_Resources_Version'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not found
        '422':
          description: Unprocessable entity
      tags:
      - ci_catalog
      operationId: postApiV4ProjectsIdCatalogPublish
definitions:
  postApiV4ProjectsIdCatalogPublish:
    type: object
    properties:
      version:
        type: string
        description: The version of the catalog resource / tag of the release to publish
      metadata:
        type: object
        description: The metadata for the release
    required:
    - version
    - metadata
    description: Publish a new component project release as version to the CI/CD catalog
  API_Entities_Ci_Catalog_Resources_Version:
    type: object
    properties:
      catalog_url:
        type: string
        example: https://gitlab.example.com/explore/catalog/my-namespace/my-component-project
    required:
    - catalog_url
    description: API_Entities_Ci_Catalog_Resources_Version model
securityDefinitions:
  access_token_header:
    type: apiKey
    name: PRIVATE-TOKEN
    in: header
  access_token_query:
    type: apiKey
    name: private_token
    in: query