[Skip to main content](https://docs.gitlab.com/18.9/api/api_resources/#skipTarget) [Go to GitLab Docs homepage](https://docs.gitlab.com/18.9/)
`/`
[ What's new? ](https://about.gitlab.com/releases/whats-new/)
v18.9
  *     * [18.10 (not yet released)](https://docs.gitlab.com/api/api_resources/)
  *     * [18.9 (recently released)](https://docs.gitlab.com/18.9/api/api_resources/)
    * [18.8](https://docs.gitlab.com/18.8/api/api_resources/)
    * [18.7](https://archives.docs.gitlab.com/18.7/api/api_resources/)
  *     * [17.11](https://archives.docs.gitlab.com/17.11/api/api_resources/)
    * [16.11](https://archives.docs.gitlab.com/16.11/ee/api/api_resources.html)
  *     * [Archives](https://docs.gitlab.com/archives)


Select theme and layout
  * Light mode
  * Dark mode
  * Auto


  * Fixed width
  * Fluid width


[What's new?](https://about.gitlab.com/releases/whats-new/) [ Get free trial ](https://gitlab.com/-/trial_registrations/new?glm_source=docs.gitlab.com&amp;glm_content=navigation-cta-docs)
Toggle menu
  * [Use GitLab](https://docs.gitlab.com/18.9/user/)
  * [GitLab Duo](https://docs.gitlab.com/18.9/user/gitlab_duo/)
  * [Extend](https://docs.gitlab.com/18.9/api/)
  * [Install](https://docs.gitlab.com/18.9/install/)
  * [Administer](https://docs.gitlab.com/18.9/administration/)
  * [Subscribe](https://docs.gitlab.com/18.9/subscriptions/)
  * [Contribute](https://docs.gitlab.com/18.9/development/)
  * [Solutions](https://docs.gitlab.com/18.9/solutions/)


Select a topicUse GitLab GitLab Duo Extend Install Administer Subscribe Contribute Solutions
[Getting started](https://docs.gitlab.com/18.9/api/get_started/get_started_extending/)
[Tutorials](https://docs.gitlab.com/18.9/tutorials/develop/)
[Integrations](https://docs.gitlab.com/18.9/integration/)
[Webhooks](https://docs.gitlab.com/18.9/user/project/integrations/webhooks/)
[REST API](https://docs.gitlab.com/18.9/api/rest/)
[Resources](https://docs.gitlab.com/18.9/api/api_resources/)
[.gitignore (templates)](https://docs.gitlab.com/18.9/api/templates/gitignores/)
[.gitlab-ci.yml (templates)](https://docs.gitlab.com/18.9/api/templates/gitlab_ci_ymls/)
[Access requests](https://docs.gitlab.com/18.9/api/access_requests/)
[Agent for Kubernetes](https://docs.gitlab.com/18.9/api/cluster_agents/)
[AI Catalog admin](https://docs.gitlab.com/18.9/api/admin/ai_catalog/)
[Alert management](https://docs.gitlab.com/18.9/api/alert_management_alerts/)
[Application appearance](https://docs.gitlab.com/18.9/api/appearance/)
[Application settings](https://docs.gitlab.com/18.9/api/settings/)
[Application statistics](https://docs.gitlab.com/18.9/api/statistics/)
[Applications](https://docs.gitlab.com/18.9/api/applications/)
[Attestations](https://docs.gitlab.com/18.9/api/attestations/)
[Audit events](https://docs.gitlab.com/18.9/api/audit_events/)
[Avatar](https://docs.gitlab.com/18.9/api/avatar/)
[Branches](https://docs.gitlab.com/18.9/api/branches/)
[Broadcast messages](https://docs.gitlab.com/18.9/api/broadcast_messages/)
[Cluster discovery (certificate-based) (deprecated)](https://docs.gitlab.com/18.9/api/cluster_discovery/)
[Code Suggestions](https://docs.gitlab.com/18.9/api/code_suggestions/)
[Commits](https://docs.gitlab.com/18.9/api/commits/)
[Compliance and policy settings](https://docs.gitlab.com/18.9/api/compliance_policy_settings/)
[Composer](https://docs.gitlab.com/18.9/api/packages/composer/)
[Conan v1](https://docs.gitlab.com/18.9/api/packages/conan_v1/)
[Conan v2](https://docs.gitlab.com/18.9/api/packages/conan_v2/)
[Container registry](https://docs.gitlab.com/18.9/api/container_registry/)
[Container repository protection rules](https://docs.gitlab.com/18.9/api/container_repository_protection_rules/)
[Container virtual registry](https://docs.gitlab.com/18.9/api/container_virtual_registries/)
[Custom attributes](https://docs.gitlab.com/18.9/api/custom_attributes/)
[Database migrations](https://docs.gitlab.com/18.9/api/database_migrations/)
[Data management](https://docs.gitlab.com/18.9/api/admin/data_management/)
[Debian](https://docs.gitlab.com/18.9/api/packages/debian/)
[Debian group distributions](https://docs.gitlab.com/18.9/api/packages/debian_group_distributions/)
[Debian project distributions](https://docs.gitlab.com/18.9/api/packages/debian_project_distributions/)
[Dependencies](https://docs.gitlab.com/18.9/api/dependencies/)
[Dependency list export](https://docs.gitlab.com/18.9/api/dependency_list_export/)
[Dependency Proxy](https://docs.gitlab.com/18.9/api/dependency_proxy/)
[Deploy keys](https://docs.gitlab.com/18.9/api/deploy_keys/)
[Deploy tokens](https://docs.gitlab.com/18.9/api/deploy_tokens/)
[Deployments](https://docs.gitlab.com/18.9/api/deployments/)
[Discussions](https://docs.gitlab.com/18.9/api/discussions/)
[Dockerfile (templates)](https://docs.gitlab.com/18.9/api/templates/dockerfiles/)
[DORA4 metrics](https://docs.gitlab.com/18.9/api/dora/metrics/)
[Emoji reactions](https://docs.gitlab.com/18.9/api/emoji_reactions/)
[Environments](https://docs.gitlab.com/18.9/api/environments/)
[Epics (deprecated)](https://docs.gitlab.com/18.9/api/epics/)
[Error tracking](https://docs.gitlab.com/18.9/api/error_tracking/)
[Events](https://docs.gitlab.com/18.9/api/events/)
[Experiments](https://docs.gitlab.com/18.9/api/experiments/)
[External status checks](https://docs.gitlab.com/18.9/api/status_checks/)
[Feature flags](https://docs.gitlab.com/18.9/api/feature_flags/)
[Feature flag user lists](https://docs.gitlab.com/18.9/api/feature_flag_user_lists/)
[Freeze periods](https://docs.gitlab.com/18.9/api/freeze_periods/)
[Geo nodes (deprecated)](https://docs.gitlab.com/18.9/api/geo_nodes/)
[Geo sites](https://docs.gitlab.com/18.9/api/geo_sites/)
[GitLab Duo Chat completions](https://docs.gitlab.com/18.9/api/chat/)
[GitLab Pages](https://docs.gitlab.com/18.9/api/pages/)
[GLQL](https://docs.gitlab.com/18.9/api/glql/)
[Go Proxy](https://docs.gitlab.com/18.9/api/packages/go_proxy/)
[Google Cloud integration](https://docs.gitlab.com/18.9/api/google_cloud_integration/)
[Groups](https://docs.gitlab.com/18.9/api/groups/)
[Helm](https://docs.gitlab.com/18.9/api/packages/helm/)
[Import](https://docs.gitlab.com/18.9/api/import/)
[Instance CI/CD variables](https://docs.gitlab.com/18.9/api/instance_level_ci_variables/)
[Invitations](https://docs.gitlab.com/18.9/api/invitations/)
[Issues](https://docs.gitlab.com/18.9/api/issues/)
[Issues (epic) (deprecated)](https://docs.gitlab.com/18.9/api/epic_issues/)
[Issues statistics](https://docs.gitlab.com/18.9/api/issues_statistics/)
[Jobs](https://docs.gitlab.com/18.9/api/jobs/)
[Job artifacts](https://docs.gitlab.com/18.9/api/job_artifacts/)
[Job token scopes](https://docs.gitlab.com/18.9/api/project_job_token_scopes/)
[Keys](https://docs.gitlab.com/18.9/api/keys/)
[License](https://docs.gitlab.com/18.9/api/license/)
[Licenses (templates)](https://docs.gitlab.com/18.9/api/templates/licenses/)
[Linked epics (deprecated)](https://docs.gitlab.com/18.9/api/linked_epics/)
[Links (issue)](https://docs.gitlab.com/18.9/api/issue_links/)
[Links (epic) (deprecated)](https://docs.gitlab.com/18.9/api/epic_links/)
[Lint .gitlab-ci.yml](https://docs.gitlab.com/18.9/api/lint/)
[Markdown](https://docs.gitlab.com/18.9/api/markdown/)
[Maven](https://docs.gitlab.com/18.9/api/packages/maven/)
[Maven virtual registry](https://docs.gitlab.com/18.9/api/maven_virtual_registries/)
[Member roles](https://docs.gitlab.com/18.9/api/member_roles/)
[Merge request approvals](https://docs.gitlab.com/18.9/api/merge_request_approvals/)
[Merge request approval settings](https://docs.gitlab.com/18.9/api/merge_request_approval_settings/)
[Merge request context commits](https://docs.gitlab.com/18.9/api/merge_request_context_commits/)
[Merge requests](https://docs.gitlab.com/18.9/api/merge_requests/)
[Merge trains](https://docs.gitlab.com/18.9/api/merge_trains/)
[Metadata](https://docs.gitlab.com/18.9/api/metadata/)
[Model registry](https://docs.gitlab.com/18.9/api/model_registry/)
[Namespaces](https://docs.gitlab.com/18.9/api/namespaces/)
[Notes (comments)](https://docs.gitlab.com/18.9/api/notes/)
[Notification settings](https://docs.gitlab.com/18.9/api/notification_settings/)
[npm](https://docs.gitlab.com/18.9/api/packages/npm/)
[NuGet](https://docs.gitlab.com/18.9/api/packages/nuget/)
[Organizations](https://docs.gitlab.com/18.9/api/organizations/)
[Packages](https://docs.gitlab.com/18.9/api/packages/)
[Pages domains](https://docs.gitlab.com/18.9/api/pages_domains/)
[Personal access tokens](https://docs.gitlab.com/18.9/api/personal_access_tokens/)
[Pipeline schedules](https://docs.gitlab.com/18.9/api/pipeline_schedules/)
[Pipeline trigger tokens](https://docs.gitlab.com/18.9/api/pipeline_triggers/)
[Pipelines](https://docs.gitlab.com/18.9/api/pipelines/)
[Plan limits](https://docs.gitlab.com/18.9/api/plan_limits/)
[Product analytics](https://docs.gitlab.com/18.9/api/product_analytics/)
[Projects](https://docs.gitlab.com/18.9/api/projects/)
[PyPI](https://docs.gitlab.com/18.9/api/packages/pypi/)
[Repositories](https://docs.gitlab.com/18.9/api/repositories/)
[Repository files](https://docs.gitlab.com/18.9/api/repository_files/)
[Repository submodules](https://docs.gitlab.com/18.9/api/repository_submodules/)
[Resource group](https://docs.gitlab.com/18.9/api/resource_groups/)
[Resource iteration events](https://docs.gitlab.com/18.9/api/resource_iteration_events/)
[Resource label events](https://docs.gitlab.com/18.9/api/resource_label_events/)
[Resource milestone events](https://docs.gitlab.com/18.9/api/resource_milestone_events/)
[Resource state events](https://docs.gitlab.com/18.9/api/resource_state_events/)
[Resource weight events](https://docs.gitlab.com/18.9/api/resource_weight_events/)
[Ruby gems](https://docs.gitlab.com/18.9/api/packages/rubygems/)
[Runners](https://docs.gitlab.com/18.9/api/runners/)
[Runner controllers](https://docs.gitlab.com/18.9/api/runner_controllers/)
[Runner controller tokens](https://docs.gitlab.com/18.9/api/runner_controller_tokens/)
[Search](https://docs.gitlab.com/18.9/api/search/)
[Search migrations](https://docs.gitlab.com/18.9/api/search_admin/)
[Secure files](https://docs.gitlab.com/18.9/api/secure_files/)
[Service accounts](https://docs.gitlab.com/18.9/api/service_accounts/)
[Service Ping](https://docs.gitlab.com/18.9/api/usage_data/)
[Sidekiq metrics](https://docs.gitlab.com/18.9/api/sidekiq_metrics/)
[Sidekiq queues](https://docs.gitlab.com/18.9/api/admin_sidekiq_queues/)
[Snippet repository storage moves](https://docs.gitlab.com/18.9/api/snippet_repository_storage_moves/)
[Snippets](https://docs.gitlab.com/18.9/api/snippets/)
[Suggestions](https://docs.gitlab.com/18.9/api/suggestions/)
[System hooks](https://docs.gitlab.com/18.9/api/system_hooks/)
[Tags](https://docs.gitlab.com/18.9/api/tags/)
[Terraform registry](https://docs.gitlab.com/18.9/api/packages/terraform-modules/)
[To-Do List](https://docs.gitlab.com/18.9/api/todos/)
[Token information](https://docs.gitlab.com/18.9/api/admin/token/)
[Topics](https://docs.gitlab.com/18.9/api/topics/)
[Users](https://docs.gitlab.com/18.9/api/users/)
[Version](https://docs.gitlab.com/18.9/api/version/)
[Virtual registries cleanup policies](https://docs.gitlab.com/18.9/api/virtual_registries_cleanup_policies/)
[Vulnerabilities](https://docs.gitlab.com/18.9/api/vulnerabilities/)
[Vulnerability archive export](https://docs.gitlab.com/18.9/api/vulnerability_archive_exports/)
[Vulnerability export](https://docs.gitlab.com/18.9/api/vulnerability_exports/)
[Vulnerability findings](https://docs.gitlab.com/18.9/api/vulnerability_findings/)
[Web commits](https://docs.gitlab.com/18.9/api/web_commits/)
[Authentication](https://docs.gitlab.com/18.9/api/rest/authentication/)
[Third-party clients](https://docs.gitlab.com/18.9/api/rest/third_party_clients/)
[Deprecations and removals](https://docs.gitlab.com/18.9/api/rest/deprecations/)
[OpenAPI](https://docs.gitlab.com/18.9/api/openapi/openapi_interactive/)
[Automate storage management](https://docs.gitlab.com/18.9/user/storage_management_automation/)
[Troubleshooting](https://docs.gitlab.com/18.9/api/rest/troubleshooting/)
[GraphQL API](https://docs.gitlab.com/18.9/api/graphql/)
[OAuth 2.0 identity provider API](https://docs.gitlab.com/18.9/api/oauth2/)
[GitLab Duo CLI (duo)](https://docs.gitlab.com/18.9/user/gitlab_duo_cli/)
[GitLab CLI (glab)](https://docs.gitlab.com/18.9/cli/)
[Editor and IDE extensions](https://docs.gitlab.com/18.9/editor_extensions/)
/
  1. [GitLab Docs](https://docs.gitlab.com/18.9/)
  2. [Extend](https://docs.gitlab.com/18.9/api/)
  3. [REST API](https://docs.gitlab.com/18.9/api/rest/)
  4. [Resources](https://docs.gitlab.com/18.9/api/api_resources/)


* * *
# 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](https://docs.gitlab.com/18.9/api/api_resources/#project-resources)
  * [Group resources](https://docs.gitlab.com/18.9/api/api_resources/#group-resources)
  * [Standalone resources](https://docs.gitlab.com/18.9/api/api_resources/#standalone-resources)
  * [Template resources](https://docs.gitlab.com/18.9/api/api_resources/#template-resources)


## Project resources[](https://docs.gitlab.com/18.9/api/api_resources/#project-resources "Permalink")
The following API resources are available in the project context:
Resource | Available endpoints
---|---
[Access requests](https://docs.gitlab.com/18.9/api/access_requests/) |  `/projects/:id/access_requests` (also available for groups)
[Access tokens](https://docs.gitlab.com/18.9/api/project_access_tokens/) |  `/projects/:id/access_tokens` (also available for groups)
[Agents](https://docs.gitlab.com/18.9/api/cluster_agents/) | `/projects/:id/cluster_agents`
[Branches](https://docs.gitlab.com/18.9/api/branches/) |  `/projects/:id/repository/branches/`, `/projects/:id/repository/merged_branches`
[Commits](https://docs.gitlab.com/18.9/api/commits/) |  `/projects/:id/repository/commits`, `/projects/:id/statuses`
[Container registry](https://docs.gitlab.com/18.9/api/container_registry/) | `/projects/:id/registry/repositories`
[Container repository protection rules](https://docs.gitlab.com/18.9/api/container_repository_protection_rules/) | `/projects/:id/registry/protection/repository/rules`
[Container registry protection tag rules](https://docs.gitlab.com/18.9/api/container_registry_protection_tag_rules/) | `/projects/:id/registry/protection/tag/rules`
[Custom attributes](https://docs.gitlab.com/18.9/api/custom_attributes/) |  `/projects/:id/custom_attributes` (also available for groups and users)
[Composer distributions](https://docs.gitlab.com/18.9/api/packages/composer/) |  `/projects/:id/packages/composer` (also available for groups)
[Conan v1 distributions](https://docs.gitlab.com/18.9/api/packages/conan_v1/) |  `/projects/:id/packages/conan` (also available standalone)
[Conan v2 distributions](https://docs.gitlab.com/18.9/api/packages/conan_v2/) |  `/projects/:id/packages/conan` (also available standalone)
[Debian distributions](https://docs.gitlab.com/18.9/api/packages/debian_project_distributions/) |  `/projects/:id/debian_distributions` (also available for groups)
[Debian packages](https://docs.gitlab.com/18.9/api/packages/debian/) |  `/projects/:id/packages/debian` (also available for groups)
[Dependencies](https://docs.gitlab.com/18.9/api/dependencies/) | `/projects/:id/dependencies`
[Deploy keys](https://docs.gitlab.com/18.9/api/deploy_keys/) |  `/projects/:id/deploy_keys` (also available standalone)
[Deploy tokens](https://docs.gitlab.com/18.9/api/deploy_tokens/) |  `/projects/:id/deploy_tokens` (also available for groups and standalone)
[Deployments](https://docs.gitlab.com/18.9/api/deployments/) | `/projects/:id/deployments`
[Discussions](https://docs.gitlab.com/18.9/api/discussions/) (threaded comments) |  `/projects/:id/issues/.../discussions`, `/projects/:id/snippets/.../discussions`, `/projects/:id/merge_requests/.../discussions`, `/projects/:id/commits/.../discussions` (also available for groups)
[Draft Notes](https://docs.gitlab.com/18.9/api/draft_notes/) (comments) | `/projects/:id/merge_requests/.../draft_notes`
[Emoji reactions](https://docs.gitlab.com/18.9/api/emoji_reactions/) |  `/projects/:id/issues/.../award_emoji`, `/projects/:id/merge_requests/.../award_emoji`, `/projects/:id/snippets/.../award_emoji`
[Environments](https://docs.gitlab.com/18.9/api/environments/) | `/projects/:id/environments`
[Error Tracking](https://docs.gitlab.com/18.9/api/error_tracking/) | `/projects/:id/error_tracking/settings`
[Events](https://docs.gitlab.com/18.9/api/events/) |  `/projects/:id/events` (also available for users and standalone)
[External status checks](https://docs.gitlab.com/18.9/api/status_checks/) | `/projects/:id/external_status_checks`
[Feature flag User Lists](https://docs.gitlab.com/18.9/api/feature_flag_user_lists/) | `/projects/:id/feature_flags_user_lists`
[Feature flags](https://docs.gitlab.com/18.9/api/feature_flags/) | `/projects/:id/feature_flags`
[Freeze Periods](https://docs.gitlab.com/18.9/api/freeze_periods/) | `/projects/:id/freeze_periods`
[Go Proxy](https://docs.gitlab.com/18.9/api/packages/go_proxy/) | `/projects/:id/packages/go`
[Helm repository](https://docs.gitlab.com/18.9/api/packages/helm/) | `/projects/:id/packages/helm_repository`
[Integrations](https://docs.gitlab.com/18.9/api/project_integrations/) (Formerly “services”) | `/projects/:id/integrations`
[Invitations](https://docs.gitlab.com/18.9/api/invitations/) |  `/projects/:id/invitations` (also available for groups)
[Issue boards](https://docs.gitlab.com/18.9/api/boards/) | `/projects/:id/boards`
[Issue links](https://docs.gitlab.com/18.9/api/issue_links/) | `/projects/:id/issues/.../links`
[Issues Statistics](https://docs.gitlab.com/18.9/api/issues_statistics/) |  `/projects/:id/issues_statistics` (also available for groups and standalone)
[Issues](https://docs.gitlab.com/18.9/api/issues/) |  `/projects/:id/issues` (also available for groups and standalone)
[Iterations](https://docs.gitlab.com/18.9/api/iterations/) |  `/projects/:id/iterations` (also available for groups)
[Project CI/CD job token scope](https://docs.gitlab.com/18.9/api/project_job_token_scopes/) | `/projects/:id/job_token_scope`
[Jobs](https://docs.gitlab.com/18.9/api/jobs/) |  `/projects/:id/jobs`, `/projects/:id/pipelines/.../jobs`
[Jobs Artifacts](https://docs.gitlab.com/18.9/api/job_artifacts/) | `/projects/:id/jobs/:job_id/artifacts`
[Labels](https://docs.gitlab.com/18.9/api/labels/) | `/projects/:id/labels`
[Maven repository](https://docs.gitlab.com/18.9/api/packages/maven/) |  `/projects/:id/packages/maven` (also available for groups and standalone)
[Members](https://docs.gitlab.com/18.9/api/members/) |  `/projects/:id/members` (also available for groups)
[Merge request approvals](https://docs.gitlab.com/18.9/api/merge_request_approvals/) |  `/projects/:id/approvals`, `/projects/:id/merge_requests/.../approvals`
[Merge requests](https://docs.gitlab.com/18.9/api/merge_requests/) |  `/projects/:id/merge_requests` (also available for groups and standalone)
[Merge trains](https://docs.gitlab.com/18.9/api/merge_trains/) | `/projects/:id/merge_trains`
[Metadata](https://docs.gitlab.com/18.9/api/metadata/) | `/metadata`
[Model registry](https://docs.gitlab.com/18.9/api/model_registry/) | `/projects/:id/packages/ml_models/`
[Notes](https://docs.gitlab.com/18.9/api/notes/) (comments) |  `/projects/:id/issues/.../notes`, `/projects/:id/snippets/.../notes`, `/projects/:id/merge_requests/.../notes` (also available for groups)
[Notification settings](https://docs.gitlab.com/18.9/api/notification_settings/) |  `/projects/:id/notification_settings` (also available for groups and standalone)
[NPM repository](https://docs.gitlab.com/18.9/api/packages/npm/) | `/projects/:id/packages/npm`
[NuGet packages](https://docs.gitlab.com/18.9/api/packages/nuget/) |  `/projects/:id/packages/nuget` (also available for groups)
[Packages](https://docs.gitlab.com/18.9/api/packages/) | `/projects/:id/packages`
[Pages domains](https://docs.gitlab.com/18.9/api/pages_domains/) |  `/projects/:id/pages/domains` (also available standalone)
[Pages settings](https://docs.gitlab.com/18.9/api/pages/) | `/projects/:id/pages`
[Pipeline schedules](https://docs.gitlab.com/18.9/api/pipeline_schedules/) | `/projects/:id/pipeline_schedules`
[Pipeline triggers](https://docs.gitlab.com/18.9/api/pipeline_triggers/) | `/projects/:id/triggers`
[Pipelines](https://docs.gitlab.com/18.9/api/pipelines/) | `/projects/:id/pipelines`
[Project badges](https://docs.gitlab.com/18.9/api/project_badges/) | `/projects/:id/badges`
[Project clusters](https://docs.gitlab.com/18.9/api/project_clusters/) | `/projects/:id/clusters`
[Project import/export](https://docs.gitlab.com/18.9/api/project_import_export/) |  `/projects/:id/export`, `/projects/import`, `/projects/:id/import`
[Project milestones](https://docs.gitlab.com/18.9/api/milestones/) | `/projects/:id/milestones`
[Project snippets](https://docs.gitlab.com/18.9/api/project_snippets/) | `/projects/:id/snippets`
[Project templates](https://docs.gitlab.com/18.9/api/project_templates/) | `/projects/:id/templates`
[Project vulnerabilities](https://docs.gitlab.com/18.9/api/project_vulnerabilities/). | `/projects/:id/vulnerabilities`
[Project wikis](https://docs.gitlab.com/18.9/api/wikis/) | `/projects/:id/wikis`
[Project-level variables](https://docs.gitlab.com/18.9/api/project_level_variables/) | `/projects/:id/variables`
[Projects](https://docs.gitlab.com/18.9/api/projects/) including setting Webhooks |  `/projects`, `/projects/:id/hooks` (also available for users)
[Protected branches](https://docs.gitlab.com/18.9/api/protected_branches/) | `/projects/:id/protected_branches`
[Protected container registry](https://docs.gitlab.com/18.9/api/container_repository_protection_rules/) | `/projects/:id/registry/protection/rules`
[Protected environments](https://docs.gitlab.com/18.9/api/protected_environments/) | `/projects/:id/protected_environments`
[Protected packages](https://docs.gitlab.com/18.9/api/project_packages_protection_rules/) | `/projects/:id/packages/protection/rules`
[Protected tags](https://docs.gitlab.com/18.9/api/protected_tags/) | `/projects/:id/protected_tags`
[PyPI packages](https://docs.gitlab.com/18.9/api/packages/pypi/) |  `/projects/:id/packages/pypi` (also available for groups)
[Release links](https://docs.gitlab.com/18.9/api/releases/links/) | `/projects/:id/releases/.../assets/links`
[Releases](https://docs.gitlab.com/18.9/api/releases/) | `/projects/:id/releases`
[Remote mirrors](https://docs.gitlab.com/18.9/api/remote_mirrors/) | `/projects/:id/remote_mirrors`
[Repositories](https://docs.gitlab.com/18.9/api/repositories/) | `/projects/:id/repository`
[Repository files](https://docs.gitlab.com/18.9/api/repository_files/) | `/projects/:id/repository/files`
[Repository submodules](https://docs.gitlab.com/18.9/api/repository_submodules/) | `/projects/:id/repository/submodules`
[Resource label events](https://docs.gitlab.com/18.9/api/resource_label_events/) |  `/projects/:id/issues/.../resource_label_events`, `/projects/:id/merge_requests/.../resource_label_events` (also available for groups)
[Ruby gems](https://docs.gitlab.com/18.9/api/packages/rubygems/) | `/projects/:id/packages/rubygems`
[Runners](https://docs.gitlab.com/18.9/api/runners/) |  `/projects/:id/runners` (also available standalone)
[Search](https://docs.gitlab.com/18.9/api/search/) |  `/projects/:id/search` (also available for groups and standalone)
[Tags](https://docs.gitlab.com/18.9/api/tags/) | `/projects/:id/repository/tags`
[Terraform modules](https://docs.gitlab.com/18.9/api/packages/terraform-modules/) |  `/projects/:id/packages/terraform/modules` (also available standalone)
[Validate `.gitlab-ci.yml` file](https://docs.gitlab.com/18.9/api/lint/) | `/projects/:id/ci/lint`
[Vulnerabilities](https://docs.gitlab.com/18.9/api/vulnerabilities/) | `/vulnerabilities/:id`
[Vulnerability exports](https://docs.gitlab.com/18.9/api/vulnerability_exports/) | `/projects/:id/vulnerability_exports`
[Vulnerability findings](https://docs.gitlab.com/18.9/api/vulnerability_findings/) | `/projects/:id/vulnerability_findings`
## Group resources[](https://docs.gitlab.com/18.9/api/api_resources/#group-resources "Permalink")
The following API resources are available in the group context:
Resource | Available endpoints
---|---
[Access requests](https://docs.gitlab.com/18.9/api/access_requests/) |  `/groups/:id/access_requests/` (also available for projects)
[Access tokens](https://docs.gitlab.com/18.9/api/group_access_tokens/) |  `/groups/:id/access_tokens` (also available for projects)
[Custom attributes](https://docs.gitlab.com/18.9/api/custom_attributes/) |  `/groups/:id/custom_attributes` (also available for projects and users)
[Debian distributions](https://docs.gitlab.com/18.9/api/packages/debian_group_distributions/) |  `/groups/:id/-/packages/debian` (also available for projects)
[Deploy tokens](https://docs.gitlab.com/18.9/api/deploy_tokens/) |  `/groups/:id/deploy_tokens` (also available for projects and standalone)
[Discussions](https://docs.gitlab.com/18.9/api/discussions/) (comments and threads) |  `/groups/:id/epics/.../discussions` (also available for projects)
[Epic issues](https://docs.gitlab.com/18.9/api/epic_issues/) | `/groups/:id/epics/.../issues`
[Epic links](https://docs.gitlab.com/18.9/api/epic_links/) | `/groups/:id/epics/.../epics`
[Epics](https://docs.gitlab.com/18.9/api/epics/) | `/groups/:id/epics`
[Groups](https://docs.gitlab.com/18.9/api/groups/) |  `/groups`, `/groups/.../subgroups`
[Group badges](https://docs.gitlab.com/18.9/api/group_badges/) | `/groups/:id/badges`
[Group issue boards](https://docs.gitlab.com/18.9/api/group_boards/) | `/groups/:id/boards`
[Group iterations](https://docs.gitlab.com/18.9/api/group_iterations/) |  `/groups/:id/iterations` (also available for projects)
[Group labels](https://docs.gitlab.com/18.9/api/group_labels/) | `/groups/:id/labels`
[Group-level variables](https://docs.gitlab.com/18.9/api/group_level_variables/) | `/groups/:id/variables`
[Group milestones](https://docs.gitlab.com/18.9/api/group_milestones/) | `/groups/:id/milestones`
[Group releases](https://docs.gitlab.com/18.9/api/group_releases/) | `/groups/:id/releases`
[Group SSH certificates](https://docs.gitlab.com/18.9/api/group_ssh_certificates/) | `/groups/:id/ssh_certificates`
[Group wikis](https://docs.gitlab.com/18.9/api/group_wikis/) | `/groups/:id/wikis`
[Invitations](https://docs.gitlab.com/18.9/api/invitations/) |  `/groups/:id/invitations` (also available for projects)
[Issues](https://docs.gitlab.com/18.9/api/issues/) |  `/groups/:id/issues` (also available for projects and standalone)
[Issues Statistics](https://docs.gitlab.com/18.9/api/issues_statistics/) |  `/groups/:id/issues_statistics` (also available for projects and standalone)
[Linked epics](https://docs.gitlab.com/18.9/api/linked_epics/) | `/groups/:id/epics/.../related_epics`
[Member Roles](https://docs.gitlab.com/18.9/api/member_roles/) | `/groups/:id/member_roles`
[Members](https://docs.gitlab.com/18.9/api/members/) |  `/groups/:id/members` (also available for projects)
[Merge requests](https://docs.gitlab.com/18.9/api/merge_requests/) |  `/groups/:id/merge_requests` (also available for projects and standalone)
[Notes](https://docs.gitlab.com/18.9/api/notes/) (comments) |  `/groups/:id/epics/.../notes` (also available for projects)
[Notification settings](https://docs.gitlab.com/18.9/api/notification_settings/) |  `/groups/:id/notification_settings` (also available for projects and standalone)
[Resource label events](https://docs.gitlab.com/18.9/api/resource_label_events/) |  `/groups/:id/epics/.../resource_label_events` (also available for projects)
[Search](https://docs.gitlab.com/18.9/api/search/) |  `/groups/:id/search` (also available for projects and standalone)
## Standalone resources[](https://docs.gitlab.com/18.9/api/api_resources/#standalone-resources "Permalink")
The following API resources are available outside of project and group contexts (including `/users`):
Resource | Available endpoints
---|---
[Appearance](https://docs.gitlab.com/18.9/api/appearance/) | `/application/appearance`
[Applications](https://docs.gitlab.com/18.9/api/applications/) | `/applications`
[Audit events](https://docs.gitlab.com/18.9/api/audit_events/) | `/audit_events`
[Avatar](https://docs.gitlab.com/18.9/api/avatar/) | `/avatar`
[Broadcast messages](https://docs.gitlab.com/18.9/api/broadcast_messages/) | `/broadcast_messages`
[Code snippets](https://docs.gitlab.com/18.9/api/snippets/) | `/snippets`
[Code Suggestions](https://docs.gitlab.com/18.9/api/code_suggestions/) | `/code_suggestions`
[Custom attributes](https://docs.gitlab.com/18.9/api/custom_attributes/) |  `/users/:id/custom_attributes` (also available for groups and projects)
[Dependency list exports](https://docs.gitlab.com/18.9/api/dependency_list_export/) |  `/pipelines/:id/dependency_list_exports`, `/projects/:id/dependency_list_exports`, `/groups/:id/dependency_list_exports`, `/security/dependency_list_exports/:id`, `/security/dependency_list_exports/:id/download`
[Deploy keys](https://docs.gitlab.com/18.9/api/deploy_keys/) |  `/deploy_keys` (also available for projects)
[Deploy tokens](https://docs.gitlab.com/18.9/api/deploy_tokens/) |  `/deploy_tokens` (also available for projects and groups)
[Events](https://docs.gitlab.com/18.9/api/events/) |  `/events`, `/users/:id/events` (also available for projects)
[Feature flags](https://docs.gitlab.com/18.9/api/features/) | `/features`
[Geo Nodes](https://docs.gitlab.com/18.9/api/geo_nodes/) | `/geo_nodes`
[GLQL](https://docs.gitlab.com/18.9/api/glql/) | `/glql`
[Group Activity Analytics](https://docs.gitlab.com/18.9/api/group_activity_analytics/) | `/analytics/group_activity/{issues_count}`
[Group repository storage moves](https://docs.gitlab.com/18.9/api/group_repository_storage_moves/) | `/group_repository_storage_moves`
[Import repository from GitHub](https://docs.gitlab.com/18.9/api/import/#import-repository-from-github) | `/import/github`
[Import repository from Bitbucket Server](https://docs.gitlab.com/18.9/api/import/#import-repository-from-bitbucket-server) | `/import/bitbucket_server`
[Instance clusters](https://docs.gitlab.com/18.9/api/instance_clusters/) | `/admin/clusters`
[Instance-level CI/CD variables](https://docs.gitlab.com/18.9/api/instance_level_ci_variables/) | `/admin/ci/variables`
[Issues Statistics](https://docs.gitlab.com/18.9/api/issues_statistics/) |  `/issues_statistics` (also available for groups and projects)
[Issues](https://docs.gitlab.com/18.9/api/issues/) |  `/issues` (also available for groups and projects)
[Jobs](https://docs.gitlab.com/18.9/api/jobs/) | `/job`
[Keys](https://docs.gitlab.com/18.9/api/keys/) | `/keys`
[License](https://docs.gitlab.com/18.9/api/license/) | `/license`
[Markdown](https://docs.gitlab.com/18.9/api/markdown/) | `/markdown`
[Merge requests](https://docs.gitlab.com/18.9/api/merge_requests/) |  `/merge_requests` (also available for groups and projects)
[Namespaces](https://docs.gitlab.com/18.9/api/namespaces/) | `/namespaces`
[Notification settings](https://docs.gitlab.com/18.9/api/notification_settings/) |  `/notification_settings` (also available for groups and projects)
[Compliance and Policy settings](https://docs.gitlab.com/18.9/api/compliance_policy_settings/) | `/admin/security/compliance_policy_settings`
[Pages domains](https://docs.gitlab.com/18.9/api/pages_domains/) |  `/pages/domains` (also available for projects)
[Personal access tokens](https://docs.gitlab.com/18.9/api/personal_access_tokens/) | `/personal_access_tokens`
[Plan limits](https://docs.gitlab.com/18.9/api/plan_limits/) | `/application/plan_limits`
[Project repository storage moves](https://docs.gitlab.com/18.9/api/project_repository_storage_moves/) | `/project_repository_storage_moves`
[Projects](https://docs.gitlab.com/18.9/api/projects/) |  `/users/:id/projects` (also available for projects)
[Runners](https://docs.gitlab.com/18.9/api/runners/) |  `/runners` (also available for projects)
[Search](https://docs.gitlab.com/18.9/api/search/) |  `/search` (also available for groups and projects)
[Service Data](https://docs.gitlab.com/18.9/api/usage_data/) |  `/usage_data` (For GitLab instance [Administrator](https://docs.gitlab.com/18.9/user/permissions/) users only)
[Settings](https://docs.gitlab.com/18.9/api/settings/) | `/application/settings`
[Sidekiq metrics](https://docs.gitlab.com/18.9/api/sidekiq_metrics/) | `/sidekiq`
[Sidekiq queues administration](https://docs.gitlab.com/18.9/api/admin_sidekiq_queues/) | `/admin/sidekiq/queues/:queue_name`
[Snippet repository storage moves](https://docs.gitlab.com/18.9/api/snippet_repository_storage_moves/) | `/snippet_repository_storage_moves`
[Statistics](https://docs.gitlab.com/18.9/api/statistics/) | `/application/statistics`
[Suggestions](https://docs.gitlab.com/18.9/api/suggestions/) | `/suggestions`
[System hooks](https://docs.gitlab.com/18.9/api/system_hooks/) | `/hooks`
[To-dos](https://docs.gitlab.com/18.9/api/todos/) | `/todos`
[Token information](https://docs.gitlab.com/18.9/api/admin/token/) | `/admin/token`
[Topics](https://docs.gitlab.com/18.9/api/topics/) | `/topics`
[Users](https://docs.gitlab.com/18.9/api/users/) | `/users`
[Web commits](https://docs.gitlab.com/18.9/api/web_commits/) | `/web_commits/public_key`
[Version](https://docs.gitlab.com/18.9/api/version/) | `/version`
## Template resources[](https://docs.gitlab.com/18.9/api/api_resources/#template-resources "Permalink")
Endpoints are available for:
  * [Dockerfile templates](https://docs.gitlab.com/18.9/api/templates/dockerfiles/)
  * [`.gitignore` templates](https://docs.gitlab.com/18.9/api/templates/gitignores/)
  * [GitLab CI/CD YAML templates](https://docs.gitlab.com/18.9/api/templates/gitlab_ci_ymls/)
  * [Open source license templates](https://docs.gitlab.com/18.9/api/templates/licenses/)


  * [Project resources](https://docs.gitlab.com/18.9/api/api_resources/#project-resources)
  * [Group resources](https://docs.gitlab.com/18.9/api/api_resources/#group-resources)
  * [Standalone resources](https://docs.gitlab.com/18.9/api/api_resources/#standalone-resources)
  * [Template resources](https://docs.gitlab.com/18.9/api/api_resources/#template-resources)


[ ![GitLab Docs logo](https://docs.gitlab.com/18.9/gitlab-logo-footer.svg) ](https://docs.gitlab.com/18.9/)
  * [ Facebook ](https://www.facebook.com/gitlab)
  * [ LinkedIn ](https://www.linkedin.com/company/gitlab-com)
  * [ Twitter ](https://twitter.com/gitlab)
  * [ YouTube ](https://www.youtube.com/channel/UCnMGQ8QHMAnVIsI3xJrihhg)

[ ![Creative Commons License](https://docs.gitlab.com/18.9/by-sa.svg) ](https://creativecommons.org/licenses/by-sa/4.0/)
Company
  * [About GitLab](https://about.gitlab.com/company/)
  * [View pricing](https://about.gitlab.com/pricing/)
  * [Try GitLab for free](https://about.gitlab.com/free-trial/)


Feedback
  * [View page source](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/api/api_resources.md)
  * [Edit in Web IDE](https://gitlab.com/-/ide/project/gitlab-org/gitlab/edit/master/-/doc/api/api_resources.md)
  * [Contribute to GitLab](https://about.gitlab.com/community/contribute/)
  * [Suggest updates](https://gitlab.com/gitlab-org/gitlab/-/issues/new?issuable_template=Documentation)


Help & Community
  * [Get certified](https://university.gitlab.com/pages/certifications)
  * [Get support](https://about.gitlab.com/support/)
  * [Post on the GitLab forum](https://forum.gitlab.com/new-topic?title=topic%20title&body=topic%20body&tags=docs-feedback)


Resources
  * [ Terms ](https://about.gitlab.com/terms/)
  * [ Privacy statement ](https://about.gitlab.com/privacy/)
  * [ Use of generative AI ](https://docs.gitlab.com/18.9/legal/use_generative_ai/)
  * [ Acceptable use of user licenses ](https://docs.gitlab.com/18.9/legal/licensing_policy/)
