---
title: "Get list of project settings"
method: GET
path: "/projects/{projectId}/settings"
tags: ["Project Settings"]
---

# Get list of project settings

`GET /projects/{projectId}/settings`

Retrieve the global settings for a project.

## Path parameters

- `projectId` string, required

## Response `default`

- ProjectSettings
  - `initialize` object, required
  - `product_name` string, required — The name of the product.
  - `product_code` string, required — The lowercase ASCII code of the product.
  - `ui_uri_template` string, required — The template of the project UI uri
  - `variables_prefix` string, required — The prefix of the generated environment variables.
  - `bot_email` string, required — The email of the bot.
  - `application_config_file` string, required — The name of the application-specific configuration file.
  - `project_config_dir` string, required — The name of the project configuration directory.
  - `use_drupal_defaults` boolean, required — Whether to use the default Drupal-centric configuration files when missing from the repository.
  - `use_legacy_subdomains` boolean, required — Whether to use legacy subdomain scheme, that replaces `.` by `---` in development subdomains.
  - `development_service_size` '2XL' | '4XL' | 'L' | 'M' | 'S' | 'XL', required — The size of development services.
  - `development_application_size` '2XL' | '4XL' | 'L' | 'M' | 'S' | 'XL', required — The size of development applications.
  - `enable_certificate_provisioning` boolean, required — Enable automatic certificate provisioning.
  - `certificate_style` 'ecdsa' | 'rsa', required
  - `certificate_renewal_activity` boolean, required — Create an activity for certificate renewal
  - `development_domain_template` string, nullable, required — The template of the development domain, can include {project} and {environment} placeholders.
  - `enable_state_api_deployments` boolean, required — Enable the State API-driven deployments on regions that support them.
  - `temporary_disk_size` integer, nullable, required — Set the size of the temporary disk (/tmp, in MB).
  - `local_disk_size` integer, nullable, required — Set the size of the instance disk (in MB).
  - `cron_minimum_interval` integer, required — Minimum interval between cron runs (in minutes)
  - `cron_maximum_jitter` integer, required — Maximum jitter inserted in cron runs (in minutes)
  - `cron_production_expiry_interval` integer, required — The interval (in days) for which cron activity and logs are kept around
  - `cron_non_production_expiry_interval` integer, required — The interval (in days) for which cron activity and logs are kept around
  - `concurrency_limits` object, required — The concurrency limits applied to different kind of activities
  - `flexible_build_cache` boolean, required — Enable the flexible build cache implementation
  - `strict_configuration` boolean, required — Strict configuration validation.
  - `has_sleepy_crons` boolean, required
  - `crons_in_git` boolean, required
  - `custom_error_template` string, nullable, required — Custom error template for the router.
  - `app_error_page_template` string, nullable, required — Custom error template for the application.
  - `environment_name_strategy` 'hash' | 'name-and-hash', required — The strategy used to generate environment machine names
  - `data_retention` object, nullable, required — Data retention configuration
  - `enable_codesource_integration_push` boolean, required — Enable pushing commits to codesource integration.
  - `enforce_mfa` boolean, required — Enforce multi-factor authentication.
  - `systemd` boolean, required — Use systemd images.
  - `router_gen2` boolean, required — Use the router v2 image.
  - `build_resources` object, required
    - `cpu` number, float, required
    - `memory` integer, required
  - `outbound_restrictions_default_policy` 'allow' | 'deny', required — The default policy for firewall outbound restrictions
  - `self_upgrade` boolean, required — Whether self-upgrades are enabled
  - `self_upgrade_latest_major` boolean, required
  - `additional_hosts` object, required — A mapping of hostname to ip address to be added to the container's hosts file
  - `max_allowed_routes` integer, required — Maximum number of routes allowed
  - `max_allowed_redirects_paths` integer, required — Maximum number of redirect paths allowed
  - `enable_incremental_backups` boolean, required — Enable incremental backups on regions that support them.
  - `sizing_api_enabled` boolean, required — Enable sizing api.
  - `enable_cache_grace_period` boolean, required — Enable cache grace period.
  - `enable_zero_downtime_deployments` boolean, required — Enable zero-downtime deployments for resource-only changes.
  - `enable_admin_agent` boolean, required
  - `certifier_url` string, required — The certifier url
  - `centralized_permissions` boolean, required — Whether centralized permissions are enabled
  - `glue_server_max_request_size` integer, required — Maximum size of request to glue-server (in MB)
  - `persistent_endpoints_ssh` boolean, required — Enable SSH access update with persistent endpoint
  - `persistent_endpoints_ssl_certificates` boolean, required — Enable SSL certificate update with persistent endpoint
  - `enable_disk_health_monitoring` boolean, required
  - `enable_paused_environments` boolean, required
  - `enable_unified_configuration` boolean, required
  - `enable_routes_tracing` boolean, required — Enable tracing support in routes
  - `image_deployment_validation` boolean, required — Enable extended deployment validation by images
  - `support_generic_images` boolean, required
  - `enable_github_app_token_exchange` boolean, required — Enable fetching the GitHub App token from SIA.
  - `continuous_profiling` object, required — The continuous profiling configuration
    - `supported_runtimes` string[], required — List of images supported for continuous profiling
  - `disable_agent_error_reporter` boolean, required
  - `requires_domain_ownership` boolean, required — Require ownership proof before domains are added to environments.
  - `enable_guaranteed_resources` boolean, required — Enable guaranteed resources feature
  - `git_server` object, required
    - `push_size_hard_limit` integer, required — Push Size Reject Limit
  - `activity_logs_max_size` integer, required — The maximum size of activity logs in bytes. This limit is applied on the pre-compressed log size.
  - `allow_manual_deployments` boolean, required — If deployments can be manual, i.e. explicitly triggered by user.
  - `allow_rolling_deployments` boolean, required — If the project can use rolling deployments.
  - `allow_burst` boolean, required
  - `router_resources` object, required — Router resource settings for flex plan
    - `baseline_cpu` number, float, required — Router baseline CPU for flex plan
    - `baseline_memory` integer, required — Router baseline memory (MB) for flex plan
    - `max_cpu` number, float, required — Router max CPU for flex plan
    - `max_memory` integer, required — Router max memory (MB) for flex plan

---

[API](https://skmtc.net/upsun/apis/upsun-com-rest-api.md) · [All operations](https://skmtc.net/upsun/apis/upsun-com-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upsun/upsun-com-rest-api/revisions/6cc88fde6435/schema)