REST API resources (FREE)
Available resources for the GitLab REST API can be grouped in the following contexts:
See also:
Project resources
The following API resources are available in the project context:
Resource | Available endpoints |
---|---|
Access requests |
/projects/:id/access_requests (also available for groups) |
Access tokens |
/projects/:id/access_tokens (also available for groups) |
Agents | /projects/:id/cluster_agents |
Award emoji |
/projects/:id/issues/.../award_emoji , /projects/:id/merge_requests/.../award_emoji , /projects/:id/snippets/.../award_emoji
|
Branches |
/projects/:id/repository/branches/ , /projects/:id/repository/merged_branches
|
Commits |
/projects/:id/repository/commits , /projects/:id/statuses
|
Container Registry | /projects/:id/registry/repositories |
Custom attributes |
/projects/:id/custom_attributes (also available for groups and users) |
Composer distributions |
/projects/:id/packages/composer (also available for groups) |
Conan distributions |
/projects/:id/packages/conan (also available standalone) |
Debian distributions |
/projects/:id/debian_distributions (also available for groups) |
Debian packages |
/projects/:id/packages/debian (also available for groups) |
Dependencies (ULTIMATE) | /projects/:id/dependencies |
Deploy keys |
/projects/:id/deploy_keys (also available standalone) |
Deploy tokens |
/projects/:id/deploy_tokens (also available for groups and standalone) |
Deployments | /projects/:id/deployments |
Discussions (threaded comments) |
/projects/:id/issues/.../discussions , /projects/:id/snippets/.../discussions , /projects/:id/merge_requests/.../discussions , /projects/:id/commits/.../discussions (also available for groups) |
Environments | /projects/:id/environments |
Error Tracking | /projects/:id/error_tracking/settings |
Events |
/projects/:id/events (also available for users and standalone) |
Feature Flag User Lists | /projects/:id/feature_flags_user_lists |
Feature Flags | /projects/:id/feature_flags |
Freeze Periods | /projects/:id/freeze_periods |
Go Proxy | /projects/:id/packages/go |
Helm repository | /projects/:id/packages/helm_repository |
Integrations (Formerly "services") | /projects/:id/integrations |
Invitations |
/projects/:id/invitations (also available for groups) |
Issue boards | /projects/:id/boards |
Issue links | /projects/:id/issues/.../links |
Issues Statistics |
/projects/:id/issues_statistics (also available for groups and standalone) |
Issues |
/projects/:id/issues (also available for groups and standalone) |
Iterations (PREMIUM) |
/projects/:id/iterations (also available for groups) |
Jobs |
/projects/:id/jobs , /projects/:id/pipelines/.../jobs
|
Jobs Artifacts | /projects/:id/jobs/:job_id/artifacts |
Labels | /projects/:id/labels |
Managed licenses (ULTIMATE) | /projects/:id/managed_licenses |
Maven repository |
/projects/:id/packages/maven (also available for groups and standalone) |
Members |
/projects/:id/members (also available for groups) |
Merge request approvals (PREMIUM) |
/projects/:id/approvals , /projects/:id/merge_requests/.../approvals
|
Merge requests |
/projects/:id/merge_requests (also available for groups and standalone) |
Merge trains | /projects/:id/merge_trains |
Metadata | /metadata |
Notes (comments) |
/projects/:id/issues/.../notes , /projects/:id/snippets/.../notes , /projects/:id/merge_requests/.../notes (also available for groups) |
Notification settings |
/projects/:id/notification_settings (also available for groups and standalone) |
NPM repository | /projects/:id/packages/npm |
NuGet packages |
/projects/:id/packages/nuget (also available for groups) |
Packages | /projects/:id/packages |
Pages domains |
/projects/:id/pages (also available standalone) |
Pipeline schedules | /projects/:id/pipeline_schedules |
Pipeline triggers | /projects/:id/triggers |
Pipelines | /projects/:id/pipelines |
Project badges | /projects/:id/badges |
Project clusters | /projects/:id/clusters |
Project import/export |
/projects/:id/export , /projects/import , /projects/:id/import
|
Project milestones | /projects/:id/milestones |
Project snippets | /projects/:id/snippets |
Project templates | /projects/:id/templates |
Project vulnerabilities (ULTIMATE) | /projects/:id/vulnerabilities |
Project wikis | /projects/:id/wikis |
Project-level variables | /projects/:id/variables |
Projects including setting Webhooks |
/projects , /projects/:id/hooks (also available for users) |
Protected branches | /projects/:id/protected_branches |
Protected environments | /projects/:id/protected_environments |
Protected tags | /projects/:id/protected_tags |
PyPI packages |
/projects/:id/packages/pypi (also available for groups) |
Release links | /projects/:id/releases/.../assets/links |
Releases | /projects/:id/releases |
Remote mirrors | /projects/:id/remote_mirrors |
Repositories | /projects/:id/repository |
Repository files | /projects/:id/repository/files |
Repository submodules | /projects/:id/repository/submodules |
Resource label events |
/projects/:id/issues/.../resource_label_events , /projects/:id/merge_requests/.../resource_label_events (also available for groups) |
Ruby gems | /projects/:id/packages/rubygems |
Runners |
/projects/:id/runners (also available standalone) |
Search |
/projects/:id/search (also available for groups and standalone) |
Tags | /projects/:id/repository/tags |
Terraform modules |
/projects/:id/packages/terraform/modules (also available standalone) |
User-starred metrics dashboards | /projects/:id/metrics/user_starred_dashboards |
Visual Review discussions (PREMIUM) | /projects/:id/merge_requests/:merge_request_id/visual_review_discussions |
Vulnerabilities (ULTIMATE) | /vulnerabilities/:id |
Vulnerability exports (ULTIMATE) | /projects/:id/vulnerability_exports |
Vulnerability findings (ULTIMATE) | /projects/:id/vulnerability_findings |
Group resources
The following API resources are available in the group context:
Resource | Available endpoints |
---|---|
Access requests |
/groups/:id/access_requests/ (also available for projects) |
Access tokens |
/groups/:id/access_tokens (also available for projects) |
Custom attributes |
/groups/:id/custom_attributes (also available for projects and users) |
Debian distributions |
/groups/:id/-/packages/debian (also available for projects) |
Deploy tokens |
/groups/:id/deploy_tokens (also available for projects and standalone) |
Discussions (comments and threads) |
/groups/:id/epics/.../discussions (also available for projects) |
Epic issues (PREMIUM) | /groups/:id/epics/.../issues |
Epic links (PREMIUM) | /groups/:id/epics/.../epics |
Epics (PREMIUM) | /groups/:id/epics |
Groups |
/groups , /groups/.../subgroups
|
Group badges | /groups/:id/badges |
Group issue boards | /groups/:id/boards |
Group iterations (PREMIUM) |
/groups/:id/iterations (also available for projects) |
Group labels | /groups/:id/labels |
Group-level variables | /groups/:id/variables |
Group milestones | /groups/:id/milestones |
Group releases | /groups/:id/releases |
Group wikis (PREMIUM) | /groups/:id/wikis |
Invitations |
/groups/:id/invitations (also available for projects) |
Issues |
/groups/:id/issues (also available for projects and standalone) |
Issues Statistics |
/groups/:id/issues_statistics (also available for projects and standalone) |
Linked epics | /groups/:id/epics/.../related_epics |
Members |
/groups/:id/members (also available for projects) |
Merge requests |
/groups/:id/merge_requests (also available for projects and standalone) |
Notes (comments) |
/groups/:id/epics/.../notes (also available for projects) |
Notification settings |
/groups/:id/notification_settings (also available for projects and standalone) |
Resource label events |
/groups/:id/epics/.../resource_label_events (also available for projects) |
Search |
/groups/:id/search (also available for projects and standalone) |
Standalone resources
The following API resources are available outside of project and group contexts (including /users
):
Resource | Available endpoints |
---|---|
Appearance (FREE SELF) | /application/appearance |
Applications | /applications |
Audit Events (PREMIUM SELF) | /audit_events |
Avatar | /avatar |
Broadcast messages | /broadcast_messages |
Code snippets | /snippets |
Custom attributes |
/users/:id/custom_attributes (also available for groups and projects) |
Deploy keys |
/deploy_keys (also available for projects) |
Deploy tokens |
/deploy_tokens (also available for projects and groups) |
Events |
/events , /users/:id/events (also available for projects) |
Feature flags | /features |
Geo Nodes (PREMIUM SELF) | /geo_nodes |
Group Activity Analytics | /analytics/group_activity/{issues_count} |
Group repository storage moves (PREMIUM SELF) | /group_repository_storage_moves |
Import repository from GitHub | /import/github |
Instance clusters (FREE SELF) | /admin/clusters |
Instance-level CI/CD variables (FREE SELF) | /admin/ci/variables |
Issues Statistics |
/issues_statistics (also available for groups and projects) |
Issues |
/issues (also available for groups and projects) |
Jobs | /job |
Keys | /keys |
License (FREE SELF) | /license |
Markdown | /markdown |
Merge requests |
/merge_requests (also available for groups and projects) |
Metrics dashboard annotations |
/environments/:id/metrics_dashboard/annotations , /clusters/:id/metrics_dashboard/annotations
|
Namespaces | /namespaces |
Notification settings |
/notification_settings (also available for groups and projects) |
Pages domains |
/pages/domains (also available for projects) |
Personal access tokens | /personal_access_tokens |
Plan limits | /application/plan_limits |
Project repository storage moves (FREE SELF) | /project_repository_storage_moves |
Projects |
/users/:id/projects (also available for projects) |
Runners |
/runners (also available for projects) |
Search |
/search (also available for groups and projects) |
Service Data |
/usage_data (For GitLab instance Administrator users only) |
Settings (FREE SELF) | /application/settings |
Sidekiq metrics (FREE SELF) | /sidekiq |
Sidekiq queues administration (FREE SELF) | /admin/sidekiq/queues/:queue_name |
Snippet repository storage moves (FREE SELF) | /snippet_repository_storage_moves |
Statistics | /application/statistics |
Suggestions | /suggestions |
System hooks | /hooks |
To-dos | /todos |
Topics | /topics |
Users | /users |
Validate .gitlab-ci.yml file |
/lint |
Version | /version |
Templates API resources
Endpoints are available for: