debian-mirror-gitlab/doc/api/openapi/openapi.yaml

71 lines
2.2 KiB
YAML
Raw Normal View History

2021-03-08 18:12:59 +05:30
openapi: 3.0.0
tags:
- name: version
description: Version
- name: access_requests
description: Access requests for projects and groups
2021-06-08 01:23:25 +05:30
- name: access_tokens
description: Access tokens for projects
2020-11-24 15:15:51 +05:30
info:
description: |
An OpenAPI definition for the GitLab REST API.
2021-03-08 18:12:59 +05:30
Few API resources or endpoints are currently included.
2020-11-24 15:15:51 +05:30
The intent is to expand this to match the entire Markdown documentation of the API:
<https://docs.gitlab.com/ee/api/>. Contributions are welcome.
When viewing this on gitlab.com, you can test API calls directly from the browser
against the `gitlab.com` instance, if you are logged in.
The feature uses the current [GitLab session cookie](https://docs.gitlab.com/ee/api/README.html#session-cookie),
2021-01-03 14:25:43 +05:30
so each request is made using your account.
2020-11-24 15:15:51 +05:30
2021-06-08 01:23:25 +05:30
Instructions for using this tool can be found in [Interactive API Documentation](openapi_interactive.md).
2021-03-08 18:12:59 +05:30
version: v4
title: GitLab API
termsOfService: 'https://about.gitlab.com/terms/'
2020-11-24 15:15:51 +05:30
license:
2021-03-08 18:12:59 +05:30
name: CC BY-SA 4.0
url: 'https://gitlab.com/gitlab-org/gitlab/-/blob/master/LICENSE'
2020-11-24 15:15:51 +05:30
servers:
2021-03-08 18:12:59 +05:30
- url: 'https://gitlab.com/api/'
security:
- ApiKeyAuth: []
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: Private-Token
2020-11-24 15:15:51 +05:30
paths:
2021-03-08 18:12:59 +05:30
# VERSION
2020-11-24 15:15:51 +05:30
/v4/version:
2021-03-08 18:12:59 +05:30
$ref: 'v4/version.yaml'
# ACCESS REQUESTS (PROJECTS)
/v4/projects/{id}/access_requests:
$ref: 'v4/access_requests.yaml#/accessRequestsProjects'
/v4/projects/{id}/access_requests/{user_id}/approve:
$ref: 'v4/access_requests.yaml#/accessRequestsProjectsApprove'
/v4/projects/{id}/access_requests/{user_id}:
$ref: 'v4/access_requests.yaml#/accessRequestsProjectsDeny'
# ACCESS REQUESTS (GROUPS)
/v4/groups/{id}/access_requests:
$ref: 'v4/access_requests.yaml#/accessRequestsGroups'
/v4/groups/{id}/access_requests/{user_id}/approve:
$ref: 'v4/access_requests.yaml#/accessRequestsGroupsApprove'
2021-06-08 01:23:25 +05:30
/v4/groups/{id}/access_requests/{user_id}:
2021-03-08 18:12:59 +05:30
$ref: 'v4/access_requests.yaml#/accessRequestsGroupsDeny'
2021-06-08 01:23:25 +05:30
# ACCESS REQUESTS (PROJECTS)
/v4/projects/{id}/access_tokens:
$ref: 'v4/access_tokens.yaml#/accessTokens'
/v4/projects/{id}/access_tokens/{token_id}:
$ref: 'v4/access_tokens.yaml#/accessTokensRevoke'