Plan limits

Use this API to retrieve and change the application limits of a subscription plan.

The available plans depend on the GitLab edition. In the Community Edition, only the default plan exists. The Enterprise Edition has additional plans.

These endpoints require administrator access to the instance.

Get current plan limits

GET /api/v4/application/plan_limits

List the current limits of a plan on the GitLab instance.

Parameters

Name	Type	Description
`plan_name` Query	String	Name of the plan to get the limits from. Default: default Allowed values: `default` Default: `default`

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPlanLimit
`400`	Bad Request	—
`401`	Unauthorized	—
`403`	Forbidden	—

Change plan limits

PUT /api/v4/application/plan_limits

Modify the limits of a plan on the GitLab instance.

Request body (application/json)

Property	Type	Description
`cargo_max_file_size`	Integer	Maximum Cargo package file size in bytes
`ci_active_jobs`	Integer	Total number of jobs in currently active pipelines
`ci_instance_level_variables`	Integer	Maximum number of Instance-level CI/CD variables that can be defined
`ci_needs_size_limit`	Integer	Maximum number of needs dependencies that a job can have
`ci_pipeline_schedules`	Integer	Maximum number of pipeline schedules
`ci_pipeline_size`	Integer	Maximum number of jobs in a single pipeline
`ci_project_subscriptions`	Integer	Maximum number of pipeline subscriptions to and from a project
`ci_registered_group_runners`	Integer	Maximum number of runners created or active in a group during the past seven days
`ci_registered_project_runners`	Integer	Maximum number of runners created or active in a project during the past seven days
`conan_max_file_size`	Integer	Maximum Conan package file size in bytes
`dotenv_size`	Integer	Maximum size of a dotenv artifact in bytes
`dotenv_variables`	Integer	Maximum number of variables in a dotenv artifact
`enforcement_limit`	Integer	Maximum storage size for the root namespace enforcement in MiB
`generic_packages_max_file_size`	Integer	Maximum generic package file size in bytes
`helm_max_file_size`	Integer	Maximum Helm chart file size in bytes
`maven_max_file_size`	Integer	Maximum Maven package file size in bytes
`max_pipelines_per_merge_train`	Integer	Maximum number of parallel pipelines per merge train
`notification_limit`	Integer	Maximum storage size for the root namespace notifications in MiB
`npm_max_file_size`	Integer	Maximum NPM package file size in bytes
`nuget_max_file_size`	Integer	Maximum NuGet package file size in bytes
`pipeline_hierarchy_size`	Integer	Maximum number of downstream pipelines in a pipeline’s hierarchy tree
`plan_name` Required	String	Name of the plan to update Allowed values: `default` Minimum length: `1`
`pypi_max_file_size`	Integer	Maximum PyPI package file size in bytes
`service_desk_outbound_emails_per_day`	Integer	Maximum number of outbound Service Desk emails per day, per top-level namespace. 0 for unlimited
`service_desk_outbound_emails_per_hour`	Integer	Maximum number of outbound Service Desk emails per hour, per top-level namespace. 0 for unlimited
`storage_size_limit`	Integer	Maximum storage size for the root namespace in MiB
`terraform_module_max_file_size`	Integer	Maximum Terraform Module package file size in bytes
`web_hook_calls`	Integer	Maximum number of times a webhook can be called per minute, per top-level namespace. 0 for unlimited
`web_hook_calls_low`	Integer	Maximum number of times a webhook can be called per minute, per top-level namespace. 0 for unlimited (GitLab.com only)
`web_hook_calls_mid`	Integer	Maximum number of times a webhook can be called per minute, per top-level namespace. 0 for unlimited (GitLab.com only)

Responses

Code	Description	Schema
`200`	OK	APIEntitiesPlanLimit
`400`	Bad request	—
`401`	Unauthorized	—
`403`	Forbidden	—

Schemas

Objects returned by the operations above and objects nested in their request bodies.

APIEntitiesPlanLimit

Property	Type	Description
`cargo_max_file_size`	Integer	Example: `5.36870912e+09`
`ci_active_jobs`	Integer	Example: `0`
`ci_instance_level_variables`	Integer	Example: `25`
`ci_needs_size_limit`	Integer	Example: `50`
`ci_pipeline_schedules`	Integer	Example: `10`
`ci_pipeline_size`	Integer	Example: `0`
`ci_project_subscriptions`	Integer	Example: `2`
`ci_registered_group_runners`	Integer	Example: `1000`
`ci_registered_project_runners`	Integer	Example: `1000`
`conan_max_file_size`	Integer	Example: `3.221225472e+09`
`dotenv_size`	Integer	Example: `5120`
`dotenv_variables`	Integer	Example: `20`
`enforcement_limit`	Integer	Example: `15000`
`generic_packages_max_file_size`	Integer	Example: `5.36870912e+09`
`helm_max_file_size`	Integer	Example: `5.24288e+06`
`limits_history`	Object	Example: `{"enforcement_limit":[{"timestamp":1686909124,"user_id":1,"username":"x","value":5}],"notification_limit":[{"timestamp":1686909124,"user_id":2,"username":"y","value":7}]}`
`maven_max_file_size`	Integer	Example: `3.221225472e+09`
`max_pipelines_per_merge_train`	Integer	Example: `20`
`notification_limit`	Integer	Example: `15000`
`npm_max_file_size`	Integer	Example: `5.24288e+08`
`nuget_max_file_size`	Integer	Example: `5.24288e+08`
`pipeline_hierarchy_size`	Integer	Example: `1000`
`pypi_max_file_size`	Integer	Example: `3.221225472e+09`
`service_desk_outbound_emails_per_day`	Integer	Example: `700`
`service_desk_outbound_emails_per_hour`	Integer	Example: `100`
`storage_size_limit`	Integer	Example: `15000`
`terraform_module_max_file_size`	Integer	Example: `1.073741824e+09`
`web_hook_calls`	Integer	Example: `500`
`web_hook_calls_low`	Integer	Example: `500`
`web_hook_calls_mid`	Integer	Example: `500`

Get current plan limits

Change plan limits

Schemas

APIEntitiesPlanLimit

Request trial access

Thank you

Error

Request callback

Thank you

Something went wrong

Book your sessions

Thank you

Error

Request demo

Thank you

Error

Get the PCI SSC Compliance Report

Thank you

Error