Improve collaboration by integrating GitLab data directly into your applications. Manage CI/CD processes across multiple projects with precision. Control user access programmatically to maintain consistent permissions across your organization. The REST API uses standard HTTP methods and JSON data formats for compatibility with your existing tools and systems. ... Submit a request to an API endpoint by using a REST API client.

Retrieves the specified project. This endpoint can be accessed without authentication if the project is publicly accessible. ... curl --header "PRIVATE-TOKEN: <your_access_token>" \ --header "Accept: application/json" \ --url "https://gitlab.example.com/api/v4/projects/<project_id>"

GitLab REST API resources organized by context (project, group, standalone, and templates) with endpoint paths.

February 16, 2022 - REST API endpoint’s domain for GitLab SaaS account Hi there! I am trying to integrate GitLab with our web application using GitLab API. What I’d like to do is getting users’ information via this endpoint. Our account …

Use the GitLab REST API for programmatic interaction with GitLab.

For the full list of available options and how to obtain these tokens, please see https://docs.gitlab.com/api/rest/authentication/.

If an endpoint has path parameters, the documentation displays them with a preceding colon. ... The :id path parameter needs to be replaced with the project ID, and the :group_id needs to be replaced with the ID of the group. The colons : shouldn't be included. The resulting cURL request for a project with ID 5 and a group ID of 17 is then: curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/share/17"

The API parameter scope=blob only works when you have a license that allows you to use the (non-free) "Advanced Search" functionality of GitLab.

The following example will only make one API call to the GitLab server to star a project (the previous example used 2 API calls): # star a git repository project = gl.projects.get(1, lazy=True) # no API call project.star() # API call · All endpoints that support get() and list() also support a head() method.

July 1, 2026 - An OpenAPI definition for the GitLab REST API. Few API resources or endpoints are currently included. The intent is to expand this to match the entire Markdown documentation of ...

By default, this request returns 20 results at a time because the API results are paginated · This endpoint supports both offset-based and keyset-based pagination, but keyset-based pagination is strongly recommended when requesting consecutive pages of results. Jobs are returned by ID in descending order. ... curl --globoff \ --header "PRIVATE-TOKEN: <your_access_token>" \ --url "https://gitlab.example.com/api/v4/projects/1/jobs?scope[]=pending&scope[]=running"

Most API requests require authentication, or return only public data when authentication isn’t provided. When authentication is not required, the documentation for each endpoint specifies this. For example, the /projects/:id endpoint does not require authentication. You can authenticate with the GitLab ...

If an endpoint has path parameters, the documentation displays them with a preceding colon. ... The :id path parameter needs to be replaced with the project ID, and the :group_id needs to be replaced with the ID of the group. The colons : shouldn't be included. The resulting cURL request for a project with ID 5 and a group ID of 17 is then: curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/share/17"

An OpenAPI definition for the GitLab REST API. Few API resources or endpoints are currently included.

This is the endpoint that gets called from GitLab Shell to provide information for LFS clients when the repository is accessed over SSH. ... curl --request POST --header "Gitlab-Shell-Api-Request: <JWT token>" \ --data "key_id=11&project=gnuwget/wget2" "http://localhost:3001/api/v4/internal/lfs_authenticate"

curl --request POST \ --header "PRIVATE-TOKEN: <your_access_token>" \ --header "Content-Type: application/json" \ --data '{"path": "<subgroup_path>", "name": "<subgroup_name>", "parent_id": <parent_group_id> }' \ --url "https://gitlab.example.com/api/v4/groups/" ... Moved from GitLab Premium to GitLab Free in GitLab 18.0. Schedules a group for deletion. Groups are deleted at the end of the retention period: On GitLab.com, groups are retained for 30 days. On GitLab Self-Managed, the retention period is controlled by the instance settings. This endpoint can also immediately delete a subgroup that was previously scheduled for deletion.

Use this API to manage runners registered to an instance. To create a new instance, group, or project runner, use the POST /user/runners endpoint.

May 22, 2023 - This endpoint is subject to merge requests diff limits. Merge requests that exceed the diff limits return limited results. Show raw diffs of the files changed in a merge request. GET /projects/:id/merge_requests/:merge_request_iid/raw_diffs ... curl --header "PRIVATE-TOKEN: <your_access_token>" \ --url "https://gitlab.example.com/api...

July 23, 2025 - The GitLab API is a RESTful API that allows you to interact with GitLab servers and automate workflows. It provides endpoints to manage projects, users, groups, issues, pipelines, and more.