SonarSource project_links API

Manage projects links.

OpenAPI Specification

sonarsource-project-links-api-openapi.yml Raw ↑
openapi: 3.0.3
info:
  title: SonarQube Cloud Web authentication project_links API
  version: v1
  description: The SonarQube Cloud Web API, derived faithfully from the machine-readable service catalog the instance publishes at /api/webservices/list.
  x-derived-from: https://sonarcloud.io/api/webservices/list
  contact:
    name: SonarSource
    url: https://community.sonarsource.com/
servers:
- url: https://sonarcloud.io
security:
- bearerToken: []
- basicToken: []
tags:
- name: project_links
  description: Manage projects links.
paths:
  /api/project_links/create:
    post:
      operationId: projectLinksCreate
      summary: Create a new project link. Requires 'Administer' permission on the specified project, or global 'Administer' permission.
      description: Create a new project link. Requires 'Administer' permission on the specified project, or global 'Administer' permission.
      tags:
      - project_links
      parameters:
      - name: name
        in: query
        description: Link name
        required: true
        schema:
          type: string
          maxLength: 128
        example: Custom
      - name: projectId
        in: query
        description: Project id
        required: false
        schema:
          type: string
        example: AU-Tpxb--iU5OvuD2FLy
      - name: projectKey
        in: query
        description: Project key
        required: false
        schema:
          type: string
        example: my_project
      - name: url
        in: query
        description: Link url
        required: true
        schema:
          type: string
          maxLength: 2048
        example: http://example.com
      responses:
        '200':
          description: OK
        '400':
          description: Bad Request
        '401':
          description: Unauthorized - authentication required
        '403':
          description: Insufficient privileges
        '404':
          description: Not Found
  /api/project_links/delete:
    post:
      operationId: projectLinksDelete
      summary: Delete existing project link. Requires 'Administer' permission on the specified project, or global 'Administer' permi...
      description: Delete existing project link. Requires 'Administer' permission on the specified project, or global 'Administer' permission.
      tags:
      - project_links
      parameters:
      - name: id
        in: query
        description: Link id
        required: true
        schema:
          type: string
        example: '17'
      responses:
        '200':
          description: OK
        '400':
          description: Bad Request
        '401':
          description: Unauthorized - authentication required
        '403':
          description: Insufficient privileges
        '404':
          description: Not Found
  /api/project_links/search:
    get:
      operationId: projectLinksSearch
      summary: List links of a project. The 'projectId' or 'projectKey' must be provided. Requires one of the following permissions:...
      description: List links of a project. The 'projectId' or 'projectKey' must be provided. Requires one of the following permissions:'Administer' rights on the specified project'Browse' on the specified project
      tags:
      - project_links
      parameters:
      - name: projectId
        in: query
        description: Project Id
        required: false
        schema:
          type: string
        example: AU-Tpxb--iU5OvuD2FLy
      - name: projectKey
        in: query
        description: Project Key
        required: false
        schema:
          type: string
        example: my_project
      responses:
        '200':
          description: OK
        '400':
          description: Bad Request
        '401':
          description: Unauthorized - authentication required
        '403':
          description: Insufficient privileges
        '404':
          description: Not Found
components:
  securitySchemes:
    bearerToken:
      type: http
      scheme: bearer
      description: User token as Bearer token.
    basicToken:
      type: http
      scheme: basic
      description: User token as HTTP Basic username with empty password.