kotovalexarian-likes-gitlab/gitlab-org--gitlab-foss
1
0
Fork 0
Code Releases Activity
gitlab-org--gitlab-foss/doc/api/managed_licenses.md
Marcel Amirault 73c6477b7e Changing badges to use parentheses not brackets 
Previously, we used brackets to denote the tier badges,
but this made Kramdown, the docs site Markdown renderer,
show many warnings when building the site. This is now
fixed by using parentheses instead of square brackets.

This was caused by [PREMIUM] looking like a link to
Kramdown, which couldn't find a URL there.

See:
- https://gitlab.com/gitlab-com/gitlab-docs/merge_requests/484
- https://gitlab.com/gitlab-org/gitlab-ce/issues/63800
2019-07-08 08:50:38 +00:00

4.2 KiB
Raw Blame History

Managed Licenses API (ULTIMATE)

List managed licenses

Get all managed licenses for a given project.

GET /projects/:id/managed_licenses
Attribute Type Required Description
id integer/string yes The ID or URL-encoded path of the project 
curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/projects/1/managed_licenses

Example response:

[
  {
    "id": 1,
    "name": "MIT",
    "approval_status": "approved"
  },
  {
    "id": 3,
    "name": "ISC",
    "approval_status": "blacklisted"
  }
]

Show an existing managed license

Shows an existing managed license.

GET /projects/:id/managed_licenses/:managed_license_id
Attribute Type Required Description
id integer/string yes The ID or URL-encoded path of the project owned by the authenticated user
managed_license_id integer/string yes The ID or URL-encoded name of the license belonging to the project 
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/managed_licenses/6"

Example response:

{
  "id": 1,
  "name": "MIT",
  "approval_status": "blacklisted"
}

Create a new managed license

Creates a new managed license for the given project with the given name and approval status.

POST /projects/:id/managed_licenses
Attribute Type Required Description
id integer/string yes The ID or URL-encoded path of the project owned by the authenticated user
name string yes The name of the managed license
approval_status string yes The approval status. "approved" or "blacklisted" 
curl --data "name=MIT&approval_status=blacklisted" --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/managed_licenses"

Example response:

{
  "id": 1,
  "name": "MIT",
  "approval_status": "approved"
}

Delete a managed license

Deletes a managed license with a given id.

DELETE /projects/:id/managed_licenses/:managed_license_id
Attribute Type Required Description
id integer/string yes The ID or URL-encoded path of the project owned by the authenticated user
managed_license_id integer/string yes The ID or URL-encoded name of the license belonging to the project 
curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/managed_licenses/4"

When successful, it replies with an HTTP 204 response.

Edit an existing managed license

Updates an existing managed license with a new approval status.

PATCH /projects/:id/managed_licenses/:managed_license_id
Attribute Type Required Description
id integer/string yes The ID or URL-encoded path of the project owned by the authenticated user
managed_license_id integer/string yes The ID or URL-encoded name of the license belonging to the project
approval_status string yes The approval status. "approved" or "blacklisted" 
curl --request PATCH --data "approval_status=blacklisted" --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/managed_licenses/6"

Example response:

{
  "id": 1,
  "name": "MIT",
  "approval_status": "blacklisted"
}