2021-01-29 00:20:46 +05:30
---
2021-10-27 15:23:28 +05:30
stage: Ecosystem
group: Integrations
2021-02-22 17:27:13 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2021-01-29 00:20:46 +05:30
---
2021-09-30 23:02:18 +05:30
# REST API resources **(FREE)**
2019-10-12 21:52:04 +05:30
2021-09-30 23:02:18 +05:30
Available resources for the [GitLab REST API ](index.md ) can be grouped in the following contexts:
2019-10-12 21:52:04 +05:30
- [Projects ](#project-resources ).
- [Groups ](#group-resources ).
- [Standalone ](#standalone-resources ).
See also:
- [V3 to V4 ](v3_to_v4.md ).
2021-11-11 11:23:49 +05:30
- Adding [deploy keys for multiple projects ](deploy_keys.md#add-deploy-keys-to-multiple-projects ).
2019-10-12 21:52:04 +05:30
- [API Resources for various templates ](#templates-api-resources ).
## Project resources
The following API resources are available in the project context:
| Resource | Available endpoints |
|:--------------------------------------------------------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| [Access requests ](access_requests.md ) | `/projects/:id/access_requests` (also available for groups) |
2021-03-11 19:13:27 +05:30
| [Access tokens ](resource_access_tokens.md ) | `/projects/:id/access_tokens` |
2019-10-12 21:52:04 +05:30
| [Award emoji ](award_emoji.md ) | `/projects/:id/issues/.../award_emoji` , `/projects/:id/merge_requests/.../award_emoji` , `/projects/:id/snippets/.../award_emoji` |
| [Branches ](branches.md ) | `/projects/:id/repository/branches/` , `/projects/:id/repository/merged_branches` |
| [Commits ](commits.md ) | `/projects/:id/repository/commits` , `/projects/:id/statuses` |
| [Container Registry ](container_registry.md ) | `/projects/:id/registry/repositories` |
| [Custom attributes ](custom_attributes.md ) | `/projects/:id/custom_attributes` (also available for groups and users) |
2019-12-26 22:10:19 +05:30
| [Dependencies ](dependencies.md ) ** (ULTIMATE)** | `/projects/:id/dependencies` |
2019-10-12 21:52:04 +05:30
| [Deploy keys ](deploy_keys.md ) | `/projects/:id/deploy_keys` (also available standalone) |
2020-05-24 23:13:21 +05:30
| [Freeze Periods ](freeze_periods.md ) | `/projects/:id/freeze_periods` |
2021-09-30 23:02:18 +05:30
| [Debian distributions ](packages/debian_project_distributions.md ) | `/projects/:id/debian_distributions` (also available for groups) |
2019-10-12 21:52:04 +05:30
| [Deployments ](deployments.md ) | `/projects/:id/deployments` |
| [Discussions ](discussions.md ) (threaded comments) | `/projects/:id/issues/.../discussions` , `/projects/:id/snippets/.../discussions` , `/projects/:id/merge_requests/.../discussions` , `/projects/:id/commits/.../discussions` (also available for groups) |
| [Environments ](environments.md ) | `/projects/:id/environments` |
2020-03-13 15:44:24 +05:30
| [Error Tracking ](error_tracking.md ) | `/projects/:id/error_tracking/settings` |
2019-10-12 21:52:04 +05:30
| [Events ](events.md ) | `/projects/:id/events` (also available for users and standalone) |
2020-05-24 23:13:21 +05:30
| [Feature Flags ](feature_flags.md ) | `/projects/:id/feature_flags` |
| [Feature Flag User Lists ](feature_flag_user_lists.md ) | `/projects/:id/feature_flags_user_lists` |
2021-11-18 22:05:49 +05:30
| [Integrations ](integrations.md ) | `/projects/:id/integrations` |
2021-01-29 00:20:46 +05:30
| [Invitations ](invitations.md ) | `/projects/:id/invitations` (also available for groups) |
2019-10-12 21:52:04 +05:30
| [Issues ](issues.md ) | `/projects/:id/issues` (also available for groups and standalone) |
| [Issues Statistics ](issues_statistics.md ) | `/projects/:id/issues_statistics` (also available for groups and standalone) |
| [Issue boards ](boards.md ) | `/projects/:id/boards` |
2021-04-29 21:17:54 +05:30
| [Issue links ](issue_links.md ). | `/projects/:id/issues/.../links` |
| [Iterations ](iterations.md ) ** (PREMIUM)** | `/projects/:id/iterations` (also available for groups) |
2019-10-12 21:52:04 +05:30
| [Jobs ](jobs.md ) | `/projects/:id/jobs` , `/projects/:id/pipelines/.../jobs` |
| [Labels ](labels.md ) | `/projects/:id/labels` |
| [Managed licenses ](managed_licenses.md ) ** (ULTIMATE)** | `/projects/:id/managed_licenses` |
| [Members ](members.md ) | `/projects/:id/members` (also available for groups) |
2021-04-29 21:17:54 +05:30
| [Merge request approvals ](merge_request_approvals.md ) ** (PREMIUM)** | `/projects/:id/approvals` , `/projects/:id/merge_requests/.../approvals` |
2019-10-12 21:52:04 +05:30
| [Merge requests ](merge_requests.md ) | `/projects/:id/merge_requests` (also available for groups and standalone) |
2020-11-24 15:15:51 +05:30
| [Merge trains ](merge_trains.md ) | `/projects/:id/merge_trains` |
2019-10-12 21:52:04 +05:30
| [Notes ](notes.md ) (comments) | `/projects/:id/issues/.../notes` , `/projects/:id/snippets/.../notes` , `/projects/:id/merge_requests/.../notes` (also available for groups) |
| [Notification settings ](notification_settings.md ) | `/projects/:id/notification_settings` (also available for groups and standalone) |
2020-10-24 23:57:45 +05:30
| [Packages ](packages.md ) | `/projects/:id/packages` |
2019-10-12 21:52:04 +05:30
| [Pages domains ](pages_domains.md ) | `/projects/:id/pages` (also available standalone) |
| [Pipelines ](pipelines.md ) | `/projects/:id/pipelines` |
| [Pipeline schedules ](pipeline_schedules.md ) | `/projects/:id/pipeline_schedules` |
| [Pipeline triggers ](pipeline_triggers.md ) | `/projects/:id/triggers` |
| [Projects ](projects.md ) including setting Webhooks | `/projects` , `/projects/:id/hooks` (also available for users) |
| [Project badges ](project_badges.md ) | `/projects/:id/badges` |
| [Project clusters ](project_clusters.md ) | `/projects/:id/clusters` |
| [Project-level variables ](project_level_variables.md ) | `/projects/:id/variables` |
| [Project import/export ](project_import_export.md ) | `/projects/:id/export` , `/projects/import` , `/projects/:id/import` |
| [Project milestones ](milestones.md ) | `/projects/:id/milestones` |
| [Project snippets ](project_snippets.md ) | `/projects/:id/snippets` |
| [Project templates ](project_templates.md ) | `/projects/:id/templates` |
2021-12-11 22:18:48 +05:30
| [Project vulnerabilities ](project_vulnerabilities.md ) ** (ULTIMATE)** | `/projects/:id/templates` |
2020-05-24 23:13:21 +05:30
| [Protected environments ](protected_environments.md ) | `/projects/:id/protected_environments` |
2019-10-12 21:52:04 +05:30
| [Protected branches ](protected_branches.md ) | `/projects/:id/protected_branches` |
| [Protected tags ](protected_tags.md ) | `/projects/:id/protected_tags` |
| [Releases ](releases/index.md ) | `/projects/:id/releases` |
| [Release links ](releases/links.md ) | `/projects/:id/releases/.../assets/links` |
2020-04-08 14:13:33 +05:30
| [Remote mirrors ](remote_mirrors.md ) | `/projects/:id/remote_mirrors` |
2019-10-12 21:52:04 +05:30
| [Repositories ](repositories.md ) | `/projects/:id/repository` |
| [Repository files ](repository_files.md ) | `/projects/:id/repository/files` |
2021-03-11 19:13:27 +05:30
| [Repository submodules ](repository_submodules.md ) | `/projects/:id/repository/submodules` |
2019-10-12 21:52:04 +05:30
| [Resource label events ](resource_label_events.md ) | `/projects/:id/issues/.../resource_label_events` , `/projects/:id/merge_requests/.../resource_label_events` (also available for groups) |
| [Runners ](runners.md ) | `/projects/:id/runners` (also available standalone) |
| [Search ](search.md ) | `/projects/:id/search` (also available for groups and standalone) |
2021-11-18 22:05:49 +05:30
| [Services ](services.md ) (renamed to [Integrations ](integrations.md )) | `/projects/:id/services` |
2019-10-12 21:52:04 +05:30
| [Tags ](tags.md ) | `/projects/:id/repository/tags` |
2020-05-24 23:13:21 +05:30
| [User-starred metrics dashboards ](metrics_user_starred_dashboards.md ) | `/projects/:id/metrics/user_starred_dashboards` |
2021-04-29 21:17:54 +05:30
| [Visual Review discussions ](visual_review_discussions.md ) ** (PREMIUM)** | `/projects/:id/merge_requests/:merge_request_id/visual_review_discussions` |
2020-04-22 19:07:51 +05:30
| [Vulnerabilities ](vulnerabilities.md ) ** (ULTIMATE)** | `/vulnerabilities/:id` |
2021-12-11 22:18:48 +05:30
| [Vulnerability exports ](vulnerability_exports.md ) ** (ULTIMATE)** | `/projects/:id/vulnerability_exports` |
2020-04-22 19:07:51 +05:30
| [Vulnerability findings ](vulnerability_findings.md ) ** (ULTIMATE)** | `/projects/:id/vulnerability_findings` |
2021-01-03 14:25:43 +05:30
| [Project wikis ](wikis.md ) | `/projects/:id/wikis` |
2019-10-12 21:52:04 +05:30
## Group resources
The following API resources are available in the group context:
| Resource | Available endpoints |
|:-----------------------------------------------------------------|:---------------------------------------------------------------------------------|
| [Access requests ](access_requests.md ) | `/groups/:id/access_requests/` (also available for projects) |
| [Custom attributes ](custom_attributes.md ) | `/groups/:id/custom_attributes` (also available for projects and users) |
2021-09-30 23:02:18 +05:30
| [Debian distributions ](packages/debian_group_distributions.md ) | `/groups/:id/-/packages/debian` (also available for projects) |
2019-10-12 21:52:04 +05:30
| [Discussions ](discussions.md ) (threaded comments) ** (ULTIMATE)** | `/groups/:id/epics/.../discussions` (also available for projects) |
| [Epic issues ](epic_issues.md ) ** (ULTIMATE)** | `/groups/:id/epics/.../issues` |
| [Epic links ](epic_links.md ) ** (ULTIMATE)** | `/groups/:id/epics/.../epics` |
| [Epics ](epics.md ) ** (ULTIMATE)** | `/groups/:id/epics` |
| [Groups ](groups.md ) | `/groups` , `/groups/.../subgroups` |
| [Group badges ](group_badges.md ) | `/groups/:id/badges` |
| [Group issue boards ](group_boards.md ) | `/groups/:id/boards` |
2021-04-29 21:17:54 +05:30
| [Group iterations ](group_iterations.md ) ** (PREMIUM)** | `/groups/:id/iterations` (also available for projects) |
2019-10-12 21:52:04 +05:30
| [Group labels ](group_labels.md ) | `/groups/:id/labels` |
| [Group-level variables ](group_level_variables.md ) | `/groups/:id/variables` |
| [Group milestones ](group_milestones.md ) | `/groups/:id/milestones` |
2021-01-29 00:20:46 +05:30
| [Invitations ](invitations.md ) | `/groups/:id/invitations` (also available for projects) |
2019-10-12 21:52:04 +05:30
| [Issues ](issues.md ) | `/groups/:id/issues` (also available for projects and standalone) |
| [Issues Statistics ](issues_statistics.md ) | `/groups/:id/issues_statistics` (also available for projects and standalone) |
| [Members ](members.md ) | `/groups/:id/members` (also available for projects) |
| [Merge requests ](merge_requests.md ) | `/groups/:id/merge_requests` (also available for projects and standalone) |
| [Notes ](notes.md ) (comments) | `/groups/:id/epics/.../notes` (also available for projects) |
| [Notification settings ](notification_settings.md ) | `/groups/:id/notification_settings` (also available for projects and standalone) |
| [Resource label events ](resource_label_events.md ) | `/groups/:id/epics/.../resource_label_events` (also available for projects) |
| [Search ](search.md ) | `/groups/:id/search` (also available for projects and standalone) |
2021-01-03 14:25:43 +05:30
| [Group wikis ](group_wikis.md ) ** (PREMIUM)** | `/groups/:id/wikis` |
2019-10-12 21:52:04 +05:30
## Standalone resources
The following API resources are available outside of project and group contexts (including `/users` ):
2020-04-08 14:13:33 +05:30
| Resource | Available endpoints |
|:---------------------------------------------------|:------------------------------------------------------------------------|
2021-11-11 11:23:49 +05:30
| [Instance-level CI/CD variables ](instance_level_ci_variables.md ) ** (FREE SELF)** | `/admin/ci/variables` |
2021-03-11 19:13:27 +05:30
| [Sidekiq queues administration ](admin_sidekiq_queues.md ) ** (FREE SELF)** | `/admin/sidekiq/queues/:queue_name` |
| [Appearance ](appearance.md ) ** (FREE SELF)** | `/application/appearance` |
2020-04-08 14:13:33 +05:30
| [Applications ](applications.md ) | `/applications` |
2021-03-11 19:13:27 +05:30
| [Audit Events ](audit_events.md ) ** (PREMIUM SELF)** | `/audit_events` |
2020-04-08 14:13:33 +05:30
| [Avatar ](avatar.md ) | `/avatar` |
| [Broadcast messages ](broadcast_messages.md ) | `/broadcast_messages` |
| [Code snippets ](snippets.md ) | `/snippets` |
| [Custom attributes ](custom_attributes.md ) | `/users/:id/custom_attributes` (also available for groups and projects) |
| [Deploy keys ](deploy_keys.md ) | `/deploy_keys` (also available for projects) |
| [Events ](events.md ) | `/events` , `/users/:id/events` (also available for projects) |
| [Feature flags ](features.md ) | `/features` |
2021-03-11 19:13:27 +05:30
| [Geo Nodes ](geo_nodes.md ) ** (PREMIUM SELF)** | `/geo_nodes` |
2021-04-29 21:17:54 +05:30
| [Group Activity Analytics ](group_activity_analytics.md ) | `/analytics/group_activity/{issues_count | merge_requests_count | new_members_count }` |
2021-03-11 19:13:27 +05:30
| [Group repository storage moves ](group_repository_storage_moves.md ) ** (PREMIUM SELF)** | `/group_repository_storage_moves` |
2020-04-08 14:13:33 +05:30
| [Import repository from GitHub ](import.md ) | `/import/github` |
2021-11-11 11:23:49 +05:30
| [Instance clusters ](instance_clusters.md ) ** (FREE SELF)** | `/admin/clusters` |
2020-04-08 14:13:33 +05:30
| [Issues ](issues.md ) | `/issues` (also available for groups and projects) |
| [Issues Statistics ](issues_statistics.md ) | `/issues_statistics` (also available for groups and projects) |
2021-04-17 20:07:23 +05:30
| [Jobs ](jobs.md ) | `/job` |
2020-04-08 14:13:33 +05:30
| [Keys ](keys.md ) | `/keys` |
2021-03-11 19:13:27 +05:30
| [License ](license.md ) ** (FREE SELF)** | `/license` |
2020-04-08 14:13:33 +05:30
| [Markdown ](markdown.md ) | `/markdown` |
| [Merge requests ](merge_requests.md ) | `/merge_requests` (also available for groups and projects) |
2020-05-24 23:13:21 +05:30
| [Metrics dashboard annotations ](metrics_dashboard_annotations.md ) | `/environments/:id/metrics_dashboard/annotations` , `/clusters/:id/metrics_dashboard/annotations` |
2020-04-08 14:13:33 +05:30
| [Namespaces ](namespaces.md ) | `/namespaces` |
| [Notification settings ](notification_settings.md ) | `/notification_settings` (also available for groups and projects) |
| [Pages domains ](pages_domains.md ) | `/pages/domains` (also available for projects) |
2021-04-17 20:07:23 +05:30
| [Plan limits ](plan_limits.md ) | `/application/plan_limits` |
2020-10-24 23:57:45 +05:30
| [Personal access tokens ](personal_access_tokens.md ) | `/personal_access_tokens` |
2020-04-08 14:13:33 +05:30
| [Projects ](projects.md ) | `/users/:id/projects` (also available for projects) |
2021-03-11 19:13:27 +05:30
| [Project repository storage moves ](project_repository_storage_moves.md ) ** (FREE SELF)** | `/project_repository_storage_moves` |
2020-04-08 14:13:33 +05:30
| [Runners ](runners.md ) | `/runners` (also available for projects) |
| [Search ](search.md ) | `/search` (also available for groups and projects) |
2021-03-11 19:13:27 +05:30
| [Settings ](settings.md ) ** (FREE SELF)** | `/application/settings` |
| [Snippet repository storage moves ](snippet_repository_storage_moves.md ) ** (FREE SELF)** | `/snippet_repository_storage_moves` |
2020-04-08 14:13:33 +05:30
| [Statistics ](statistics.md ) | `/application/statistics` |
2021-03-11 19:13:27 +05:30
| [Sidekiq metrics ](sidekiq_metrics.md ) ** (FREE SELF)** | `/sidekiq` |
2020-04-08 14:13:33 +05:30
| [Suggestions ](suggestions.md ) | `/suggestions` |
| [System hooks ](system_hooks.md ) | `/hooks` |
2021-04-29 21:17:54 +05:30
| [To-dos ](todos.md ) | `/todos` |
2021-12-11 22:18:48 +05:30
| [Topics ](topics.md ) | `/topics` |
2021-09-30 23:02:18 +05:30
| [Service Data ](usage_data.md ) | `/usage_data` (For GitLab instance [Administrator ](../user/permissions.md ) users only) |
2020-04-08 14:13:33 +05:30
| [Users ](users.md ) | `/users` |
| [Validate `.gitlab-ci.yml` file ](lint.md ) | `/lint` |
| [Version ](version.md ) | `/version` |
2019-10-12 21:52:04 +05:30
## Templates API resources
Endpoints are available for:
- [Dockerfile templates ](templates/dockerfiles.md ).
- [`.gitignore` templates ](templates/gitignores.md ).
2020-04-22 19:07:51 +05:30
- [GitLab CI/CD YAML templates ](templates/gitlab_ci_ymls.md ).
2019-10-12 21:52:04 +05:30
- [Open source license templates ](templates/licenses.md ).
