REST API resources
- Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
The GitLab REST API gives you programmatic control over GitLab resources. Build integrations with your existing tools, automate repetitive tasks, and extract data for custom reports. Access and manipulate projects, groups, issues, and merge requests without using the web interface.
Use the REST API to:
- Automate project creation and user management.
- Trigger CI/CD pipelines from external systems.
- Extract issue and merge request data for custom dashboards.
- Integrate GitLab with third-party applications.
- Implement custom workflows across multiple repositories.
The REST API resources are organized into:
Project resources
The following API resources are available in the project context:
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) |
| Container virtual registry | /groups/:id/-/virtual_registries/container/registries |
| Custom attributes | /groups/:id/custom_attributes (also available for projects and users) |
| Debian distributions | /groups/:id/-/packages/debian (also available for projects) |
| Dependency Proxy | /groups/:id/dependency_proxy/cache |
| Deploy tokens | /groups/:id/deploy_tokens (also available for projects and standalone) |
| DevOps Research and Assessment (DORA) metrics | /groups/:id/dora/metrics (also available for projects) |
| Discussions (comments and threads) | /groups/:id/epics/.../discussions (also available for projects) |
| Epic issues | /groups/:id/epics/.../issues |
| Epic links | /groups/:id/epics/.../epics |
| Epics | /groups/:id/epics |
| Groups | /groups, /groups/.../subgroups |
| Group badges | /groups/:id/badges |
| Group enterprise users | /groups/:id/enterprise_users |
| Group epic boards | /groups/:id/epic_boards |
| Group import and export | /groups/:id/export, /groups/import |
| Group integrations | /groups/:id/integrations |
| Group issue boards | /groups/:id/boards |
| Group iterations | /groups/:id/iterations (also available for projects) |
| Group labels | /groups/:id/labels |
| Group Markdown uploads | /groups/:id/uploads |
| Group-level protected branches | /groups/:id/protected_branches |
| Group-level protected environments | /groups/:id/protected_environments |
| Group-level variables | /groups/:id/variables |
| Group milestones | /groups/:id/milestones |
| Group placeholder reassignments | /groups/:id/placeholder_reassignments |
| Group push rules | /groups/:id/push_rule |
| Group relations export | /groups/:id/export_relations |
| Group releases | /groups/:id/releases |
| Group security settings | /groups/:id/security_settings |
| Group SSH certificates | /groups/:id/ssh_certificates |
| Group webhooks | /groups/:id/hooks |
| Group wikis | /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) |
| LDAP group links | /groups/:id/ldap_group_links |
| Linked epics | /groups/:id/epics/.../related_epics |
| Maven virtual registry | /groups/:id/-/virtual_registries/packages/maven/registries |
| Member Roles | /groups/:id/member_roles |
| Members | /groups/:id/members (also available for projects) |
| Merge request approval settings | /groups/:id/merge_request_approval_setting (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) |
| Resource state events | /groups/:id/epics/:epic_id/resource_state_events (also available for projects) |
| SAML | /groups/:id/saml/identities, /groups/:id/saml_group_links |
| SCIM | /groups/:id/scim/identities |
| Search | /groups/:id/search (also available for projects and standalone) |
| Secrets Manager | /groups/:id/secrets_manager/access_token (also available for projects) |
| Service accounts | /groups/:id/service_accounts (also available for projects and standalone) |
| Virtual registries cleanup policies | /groups/:id/-/virtual_registries/cleanup/policy |
Standalone resources
The following API resources are available outside of project and group contexts (including /users):
Template resources
Endpoints are available for:
Was this page helpful?