Documentation Reference

Error code reference

Every error code with its HTTP status, title, hint and the page that explains it.

~46 min read
On this page
<!-- GENERATED — do not edit by hand; regenerate with `make error-codes-md`. -->

Every error Gregale returns carries a stable code. Errors explains how an error is shaped and what to do about the most common ones. This page lists each code with the HTTP status Gregale sends it with, the title and hint Gregale writes for it, and the docs page it points to. A real response's detail adds the specifics, such as the observed value, the limit or the field that failed.

The list is generated from the code that builds each error, so a new code appears here when it ships. Codes for features whose docs are not published yet are left out. Each code's name is its anchor: link to error-codes#plan_limit_apps, for example.

A

account_abuse_hold

HTTP 403 Forbidden · Account on hold

See Networking.

account_deletion_confirm_required

HTTP 409 Conflict

account_deletion_managed_postgres_databases

HTTP 409 Conflict · Managed PostgreSQL databases must be deleted first

Run gregale postgres list, then gregale postgres delete <database> --purge for each database

See Managed PostgreSQL.

account_deletion_pending

HTTP 409 Conflict

account_deploy_blocked

HTTP 409 Conflict · Deployment unavailable

account_egress_allowlist_extra_out_of_range

HTTP 400 Bad Request · Account egress allowlist extra out of range

See Networking.

account_exists

HTTP 400 Bad Request

account_not_restorable

HTTP 409 Conflict · Grace expired; Not restorable

admin_required

HTTP 403 Forbidden · Admin access required

admission_refused

HTTP 402 Payment Required · Spend cap reached

See Billing.

alert_preset_disabled

HTTP 400 Bad Request · Alert preset not yet available

See Alerts.

alert_preset_invalid

HTTP 400 Bad Request · Invalid alert preset

See Alerts.

alert_preset_test_rate_limited

HTTP 429 Too Many Requests · Alert preset test rate limited

See Alerts.

alert_rule_invalid

HTTP 400 Bad Request · Invalid alert rule

See Alerts.

api_key_expired

HTTP 401 Unauthorized · API key expired

See Authentication.

api_key_limit_exceeded

HTTP 409 Conflict · API key limit reached

See Authentication.

api_key_revoked

HTTP 401 Unauthorized · API key revoked

See Authentication.

api_rate_limited

HTTP 429 Too Many Requests · API rate limit reached

See Errors.

app_admission_unavailable

HTTP 503 Service Unavailable · App admission unavailable

app_arch_mismatch

HTTP 422 Unprocessable Entity · Unsupported CPU architecture

app_concurrency_reached

HTTP 429 Too Many Requests · App concurrency reached

See Plans and pricing.

app_deleted

HTTP 410 Gone · App deleted; App was deleted while wake was in flight

See Alerts, Crons.

app_has_buckets

HTTP 409 Conflict · Conflict

app_has_dependents

HTTP 409 Conflict · Conflict

Remove the service and its references from your Compose file, then run a reviewed deploy (gregale deploy), or delete the dependent apps first.

See Deploy a multi-service app.

app_has_postgres_bindings

HTTP 409 Conflict · Conflict

See Managed PostgreSQL.

app_health_unavailable

HTTP 503 Service Unavailable · App health is unavailable

See Errors.

app_healthz_unauthorized

HTTP 422 Unprocessable Entity · App_healthz_unauthorized; Health endpoint returning 401

app_layer_too_large

HTTP 403 Forbidden · App too large

See Builds and framework detection, Container compatibility.

app_log_drain_invalid

HTTP 400 Bad Request · Bad request; Invalid log drain

app_logs_unavailable

HTTP 503 Service Unavailable · App logs unavailable; Live logs temporarily unavailable

Retry gregale logs APP in a few seconds.

See CLI guide, Logs, Errors.

app_loopback_bound

HTTP 422 Unprocessable Entity · App bound to loopback; Application bound to loopback

See Errors.

app_maintenance_mode

HTTP 503 Service Unavailable · App in maintenance

app_manifest_invalid

HTTP 409 Conflict or 422 Unprocessable Entity · Many operations send this code; the response's title and detail name the failure.

app_not_listening

HTTP 422 Unprocessable Entity · No process listening on $PORT; App listens on a different port

See Deployment overrides, Errors, Deploy a web framework.

app_not_purgeable

HTTP 409 Conflict · App not purgeable

app_not_restorable

HTTP 409 Conflict · App not restorable

app_protocol_invalid

HTTP 400 Bad Request · Invalid app_protocol; Invalid app protocol

app_rename_failed

HTTP 409 Conflict · Slug taken

app_runtime_oom

HTTP 422 Unprocessable Entity or 503 Service Unavailable · Container out of memory; App is out of memory; App ran out of memory during startup

See Errors.

app_startup_crash

HTTP 422 Unprocessable Entity · App exited during startup

See Errors.

app_startup_timeout

HTTP 422 Unprocessable Entity · Many operations send this code; the response's title and detail name the failure.

app_static_egress_ip_invalid

HTTP 400 Bad Request · Invalid static egress IP

See Static egress IP.

app_unavailable

HTTP 503 Service Unavailable · App temporarily unavailable

Retry the request in a few seconds.

See Errors.

app_visibility_invalid

HTTP 400 Bad Request · Invalid app visibility

See Networking.

app_webhook_invalid

HTTP 400 Bad Request · Bad request; Invalid webhook

approval_denied

HTTP 403 Forbidden · Approval denied

approval_expired

HTTP 410 Gone · Approval expired

approval_required

HTTP 428 Precondition Required or 429 Too Many Requests · Approval required; Too many requests awaiting approval

auth_rate_limited

HTTP 429 Too Many Requests · Too many codes; Too many failed authentication attempts; Too many MFA disable emails

See Authentication, Errors.

B

bad_gateway

HTTP 503 Service Unavailable · App connection failed; Edge rule compile error

Retry the request; if it still fails, check the app logs.

See Quickstart, Errors.

bad_request

HTTP 400 Bad Request · Many operations send this code; the response's title and detail name the failure.

before_checkpoint_failed

HTTP 422 Unprocessable Entity · Before checkpoint callback failed

See How scaling to zero works, Functions and runtimes.

billing_already_cancelled

HTTP 409 Conflict · No active subscription

billing_cancel_failed

HTTP 503 Service Unavailable · Billing cancel failed

billing_contact_member

HTTP 409 Conflict · Member is the billing contact

See Billing.

billing_email_change_failed

HTTP 503 Service Unavailable · Billing email change failed

billing_email_in_use

HTTP 409 Conflict · Billing email in use

See Billing.

billing_past_due

HTTP 402 Payment Required · Account suspended; Deploys blocked; Payment required

See Billing.

billing_plan_change_failed

HTTP 503 Service Unavailable · Billing plan change failed

billing_provider_unavailable

HTTP 503 Service Unavailable · Payment provider unavailable

billing_subscription_ending

HTTP 409 Conflict · Subscription is scheduled to end

See Billing.

billing_unavailable

HTTP 501 Not Implemented · Billing provider not initialised; State store not initialised

binding_verification_budget_full

HTTP 429 Too Many Requests · Verification budget full

See Networking, Binding verification runs.

binding_verification_run_changed

HTTP 409 Conflict · Verification run blocked

binding_verification_run_limit

HTTP 429 Too Many Requests · Verification run limit reached

See Networking.

bindings_check_changed

HTTP 409 Conflict · Bindings check changed; Release policy changed; Service graph changed

See Errors.

bindings_check_failed

HTTP 409 Conflict · Bindings check failed

See Errors.

bindings_gate_unavailable

HTTP 503 Service Unavailable · Bindings gate unavailable

See Errors.

bindings_release_policy_changed

HTTP 409 Conflict · Release policy changed

bindings_release_required

HTTP 409 Conflict · Binding release policy blocked traffic; Exact rollback required

Verify the exact deployment receiving traffic, then promote, advance its canary, or abort with both deployment_id and expected_predecessor_deployment_id. Recovery without exact selectors requires explicitly setting the release policy to off with its current revision and a reason.

build_failed

The response's title and detail describe the failure.

build_infrastructure_failed

The response's title and detail describe the failure.

build_not_found

HTTP 404 Not Found · No such build

See Builds and framework detection.

build_oom

HTTP 503 Service Unavailable

build_provenance_not_found

HTTP 404 Not Found · Build provenance not found

See Builds and framework detection.

build_sbom_unavailable

HTTP 503 Service Unavailable · Build SBOM unavailable

See Builds and framework detection.

build_timeout

HTTP 503 Service Unavailable

build_undetected

HTTP 400 Bad Request

C

canary_step_conflict

HTTP 409 Conflict · Canary step changed

See Progressive rollouts.

capability_not_released

HTTP 403 Forbidden · Feature not available

See Plans and pricing, Edge rules.

capacity_unavailable

HTTP status varies by operation · Many operations send this code; the response's title and detail name the failure.

challenge_required

HTTP 403 Forbidden · Challenge required

See Edge rules, Security.

cli_auth_code_pending

HTTP 404 Not Found · Awaiting approval

cli_auth_code_unavailable

HTTP 410 Gone · Code unavailable

cold_wake_rate_limited

HTTP 429 Too Many Requests · Too many app wakes

companion_preset_unavailable

HTTP 503 Service Unavailable · Companion preset unavailable

See Application companions.

concurrency_queue_full

HTTP 429 Too Many Requests · Concurrency queue full

See Scaling policy.

concurrency_queue_timeout

HTTP 503 Service Unavailable · Concurrency queue wait expired

See Scaling policy.

concurrency_throttled

HTTP 429 Too Many Requests · App busy; Concurrency limit reached

config_guard_not_found

HTTP 404 Not Found · No config guard

See Environment variables.

config_revision_not_found

HTTP 404 Not Found · Config revision not found

See Environment variables.

conflict

HTTP 409 Conflict or 410 Gone · Many operations send this code; the response's title and detail name the failure.

control_plane_busy

HTTP 503 Service Unavailable · Control plane busy

control_plane_unavailable

HTTP 503 Service Unavailable · Control plane unavailable

cors_origin_not_allowed

HTTP 403 Forbidden · CORS origin not allowed

cors_preset_too_large

HTTP 422 Unprocessable Entity · CORS preset too large

See Plans and pricing.

cron_fire_now_busy

HTTP 429 Too Many Requests · Cron run already pending

See Crons.

cron_invalid

HTTP 400 Bad Request · Invalid cron path; Cron environment requires a project; Invalid cron schedule

See Crons.

csrf_mismatch

HTTP 400 Bad Request or 403 Forbidden · CSRF Error; CSRF mismatch

csrf_missing

HTTP 403 Forbidden · Missing CSRF state

custom_metric_limit

HTTP 422 Unprocessable Entity · Custom metric limit reached

D

data_upstreams_disabled

HTTP 503 Service Unavailable · Data placement is disabled

See Plans and pricing.

database_cutover_fenced

HTTP 409 Conflict · Database cutover in progress

database_switch_in_progress

HTTP 409 Conflict · Database switch in progress

database_switch_not_cancellable

HTTP 409 Conflict · Database switch cannot be cancelled

database_switch_unavailable

HTTP 409 Conflict · Database switch unavailable

See Deploys.

database_switches_active

HTTP 429 Too Many Requests · Too many database switches in progress

See Safe releases.

debug_regressions_unavailable

HTTP 503 Service Unavailable · Debugger data unavailable

debug_replay_unsupported

HTTP 409 Conflict · Debug replay is unavailable; Mirror replay is unavailable

dep_install_failed

HTTP 422 Unprocessable Entity · Dependency installation failure

See Errors.

deploy_failed

HTTP 422 Unprocessable Entity or 503 Service Unavailable · Deploy failed; Deployment artifact unavailable

See Deploys.

deploy_rate_limited

HTTP 429 Too Many Requests · Deploy rate limited

See Deploys.

deploy_settings_conflict

HTTP 409 Conflict · Deploy settings changed

deploy_signature_invalid

HTTP 403 Forbidden · Signed-image enforcement rejected the deploy

See Security.

deployment_attempt_accepted

HTTP 409 Conflict · Deployment attempt already accepted

deployment_attempt_pending

The response's title and detail describe the failure.

deployment_cancel_live_forbidden

HTTP 409 Conflict · Cannot cancel a live deployment

Use 'gregale release rollback <id>' to swap to a previous deployment.

See Deploys.

deployment_cancel_not_cancellable

HTTP 409 Conflict · Deployment is not in a cancellable state

See Deploys.

deployment_check_target_changed

HTTP 409 Conflict · Deployment target unavailable

deployment_cron_conflict

HTTP 409 Conflict · Deployment cron staging changed

deployment_hide_in_flight

HTTP 409 Conflict · Cannot hide a deployment that is still in progress

Cancel the deployment first, then hide it.

See Deploys.

deployment_not_live

HTTP 409 Conflict · Deployment is not live

See Progressive rollouts.

deployment_promotion_attempt_accepted

HTTP 409 Conflict · Promotion already accepted

deployment_promotion_attempt_conflict

HTTP 409 Conflict · Promotion attempt conflict

deployment_queue_timeout

The response's title and detail describe the failure.

See Builds and framework detection, Deploys.

deployment_reorder_not_pending

HTTP 409 Conflict · Reorder only valid for pending deployments

Cancel this deployment and re-deploy with --priority if you need queue control.

See Deploys.

deployment_reorder_priority_invalid

HTTP 422 Unprocessable Entity · Priority must be in [0, 1000]

See Deploys.

deployment_scope_collision

HTTP 409 Conflict · Scope already live

deployment_smoke_failed

HTTP 422 Unprocessable Entity

See Container compatibility.

deployment_stalled

The response's title and detail describe the failure.

See Deploys.

deployment_verification_unavailable

HTTP 503 Service Unavailable

See Container compatibility.

dev_debug_not_developer_environment

HTTP 409 Conflict · Debugging unavailable

dev_debug_session_limit

HTTP 429 Too Many Requests · Too many debugger sessions

dev_session_tearing_down

HTTP 409 Conflict · Developer environment is being removed

See gregale dev.

dev_source_base_missing

HTTP 409 Conflict · Developer source base unavailable

See gregale dev.

dev_source_diverged

HTTP 409 Conflict · Instance not snapshotted

dev_watch_unsupported

HTTP 422 Unprocessable Entity · Watch mode is for apps; Watch mode needs an authenticated environment; Watch mode needs more memory

See gregale dev.

developer_seed_failed

The response's title and detail describe the failure.

See gregale dev.

developer_sync_history_unavailable

HTTP 503 Service Unavailable · Developer sync history unavailable

domain_cert_not_issued

HTTP 422 Unprocessable Entity · Domain cert not issued

See Domains.

domain_not_verified

HTTP 409 Conflict · Domain not verified

See Domains.

domain_verification_failed

HTTP 422 Unprocessable Entity · Domain verification failed

See Domains.

dry_run_requires_post

HTTP 405 Method Not Allowed · Dry-run is POST-only; use POST /v1/apps/{slug}/openapi/dry-run

E

edge_feature_unavailable

HTTP 422 Unprocessable Entity · Edge feature not released

See Security.

edge_overloaded

HTTP 503 Service Unavailable · Edge overloaded

edge_rule_conflict

HTTP 409 Conflict · Edge rule conflict

edge_rule_list_exists

HTTP 409 Conflict · Edge rule list exists

edge_rule_list_in_use

HTTP 409 Conflict · Edge rule list in use

edge_rule_list_not_found

HTTP 404 Not Found · Edge rule list not found

edge_rule_maintenance

HTTP 503 Service Unavailable · Endpoint in maintenance

See Edge rules.

edge_rule_not_found

HTTP 404 Not Found · Edge rule not found

edge_rules_version_mismatch

HTTP 412 Precondition Failed · Edge rules changed

egress_allowlist_too_long

HTTP 400 Bad Request · Egress allowlist too long

See Networking.

egress_ports_too_many

HTTP 400 Bad Request · Too many egress ports

See Networking.

email_missing

HTTP 400 Bad Request · Missing Email

email_not_verified

HTTP 401 Unauthorized · Email not verified

See Authentication.

email_verification_required

HTTP 403 Forbidden · Email verification required

See Authentication.

empty_body

HTTP 400 Bad Request · Request body is empty

env_batch_request_conflict

HTTP 409 Conflict · Request ID already used

env_batch_revision_conflict

HTTP 409 Conflict · Configuration changed

env_scope_invalid

HTTP 400 Bad Request · Invalid env scope

See Environment variables.

env_scope_reserved

HTTP 400 Bad Request · Env scope reserved

See Environment variables.

env_value_too_large

HTTP 413 Request Entity Too Large · Invalid sidecar env; Env var value too large

See Environment variables.

env_var_invalid_key

HTTP 400 Bad Request · Invalid env var key

See Environment variables.

env_var_missing

HTTP 422 Unprocessable Entity · Missing environment variable

env_var_not_found

HTTP 400 Bad Request · Env var not set

See Environment variables.

environment_cleanup_pending

HTTP 409 Conflict · Environment cleanup in progress

environment_field_ownership_conflict

HTTP 409 Conflict · Field ownership conflict

environment_full_clone_unavailable

HTTP 409 Conflict · Full environment clone unavailable

environment_promotion_attempt_accepted

HTTP 409 Conflict · Environment promotion already accepted

environment_promotion_attempt_conflict

HTTP 409 Conflict · Environment promotion attempt conflict

environment_queue_collection_unavailable

HTTP 409 Conflict · Stage queue collection unavailable

environment_rollback_attempt_accepted

HTTP 409 Conflict · Environment rollback already accepted

environment_rollback_attempt_conflict

HTTP 409 Conflict · Environment rollback attempt conflict

environment_work_busy

HTTP 409 Conflict · Environment work is running

environment_work_ownership_conflict

HTTP 409 Conflict · Environment work ownership conflict

environment_work_policy_collection_unavailable

HTTP 409 Conflict · Stage policy collection unavailable

event_publish_batch_too_large

HTTP 413 Request Entity Too Large · Batch too large

See Errors.

event_publish_not_attempted

HTTP 503 Service Unavailable · Event not attempted

See Errors.

event_storage_capacity_exhausted

HTTP 429 Too Many Requests · Event storage capacity exhausted

See Errors.

event_stream_unavailable

The response's title and detail describe the failure.

See Errors.

exclude_only_overlap

HTTP 409 Conflict · Workload is in both --only and --exclude

exclude_unknown_slug

HTTP 400 Bad Request · Exclude slug is not a workload in this commit

execution_mode_conflict

HTTP 422 Unprocessable Entity · Execution mode conflicts with the app's behavior

See Errors.

export_rate_limited

HTTP 429 Too Many Requests · Export rate limited

See Account and organization management.

F

financial_budget_activation_unavailable

HTTP 422 Unprocessable Entity · Budget activation unavailable; Organization budgets unavailable; Strict budgets not available for organizations

See Billing.

financial_budget_held

HTTP 402 Payment Required · Compute budget held; Preview compute budget reached

financial_compute_budget_too_low

HTTP 422 Unprocessable Entity · Compute budget below committed funding

financial_compute_not_ready

HTTP 422 Unprocessable Entity · Strict compute activation unavailable; Job compute authority unavailable

financial_compute_unavailable

HTTP 503 Service Unavailable · Compute admission unavailable

forged

HTTP 403 Forbidden · GitHub installation could not be verified

function_init_failed

HTTP 422 Unprocessable Entity · Function init failed

See Errors, Functions and runtimes.

function_input_invalid

The response's title and detail describe the failure.

See Errors, Functions and runtimes.

function_send_rate_limited

HTTP 429 Too Many Requests · Function send rate limited

See Event-driven workloads.

G

gateway_overloaded

HTTP 503 Service Unavailable · Gateway overloaded

geo_denied

HTTP 403 Forbidden · Country not allowed; Country denied

See Edge rules, Errors.

github_account_conflict

HTTP 409 Conflict · GitHub deployment connection could not be saved

See Deploys.

github_app_not_installed

HTTP 404 Not Found · Gregale GitHub App not installed

Install the Gregale GitHub App on your account or organization, then connect again.

See Deploys.

github_install_ambiguous

HTTP 409 Conflict · GitHub installation is ambiguous

github_install_not_found

HTTP 404 Not Found or 409 Conflict · GitHub connection not found; GitHub installation is no longer available; No GitHub installation

See Deploy from a GitHub source ref.

github_install_not_owned

HTTP 403 Forbidden · GitHub installation is not connected to this account

github_installation_choice_required

HTTP 409 Conflict · Choose a GitHub installation

See Deploys.

github_installation_not_accessible

HTTP 403 Forbidden · GitHub installation not accessible

Sign in to GitHub as a user with access to that installation, then connect again.

See Deploys.

github_installation_owner_required

HTTP 403 Forbidden · Only the owner can connect this installation

Sign in to GitHub as that user, or install the Gregale GitHub App on your own account.

See Deploys.

github_installation_required

HTTP 409 Conflict · Choose a GitHub installation

See Deploys.

github_integration_unavailable

HTTP 503 Service Unavailable · GitHub integration unavailable

github_not_bound

HTTP 409 Conflict · GitHub is not connected to this app

github_org_admin_required

HTTP 403 Forbidden · Organization admin required

Ask an organization admin to connect GitHub, or to make you an admin.

See Deploys.

github_permission_pending

HTTP 403 Forbidden · GitHub permission not accepted

Ask an organization owner to review the pending permission request in the organization's GitHub App settings.

See Deploys.

github_repo_not_accessible

HTTP 403 Forbidden · Repository is not accessible

See Deploys.

github_unreachable

HTTP 503 Service Unavailable · GitHub Unreachable; Could not reach GitHub

Gregale could not complete the GitHub connection. Try again in a minute; if it continues, contact support.

See Deploys.

gitlab_company_project_unavailable

HTTP 409 Conflict · GitLab unavailable for company projects

gitlab_connection_required

HTTP 409 Conflict · GitLab connection required

google_id_token_invalid

HTTP 400 Bad Request · OAuth Failed

google_id_token_missing

HTTP 400 Bad Request · OAuth Failed

google_identity_mismatch

HTTP 400 Bad Request · OAuth Failed

google_unreachable

HTTP 503 Service Unavailable · Google Unreachable

H

handler_missing

HTTP 400 Bad Request · Handler required

See Functions and runtimes.

header_mutation_forbidden

HTTP 422 Unprocessable Entity · Header mutation forbidden

http_admission_unavailable

HTTP 503 Service Unavailable · Request admission unavailable

http_error

The response's title and detail describe the failure.

I

idempotency_conflict

HTTP 409 Conflict · Idempotency key conflict

idempotency_key_reused

HTTP 422 Unprocessable Entity · Idempotency-Key reused

See Errors.

image_abuse_detected

The response's title and detail describe the failure.

See Security.

image_egress_denied

HTTP 403 Forbidden · Egress denied

image_manifest_invalid

HTTP 422 Unprocessable Entity

See Container compatibility.

image_not_found

HTTP 422 Unprocessable Entity

image_required

HTTP 400 Bad Request · Image digest required

image_secret_detected

The response's title and detail describe the failure.

inbound_webhook_backlog_full

HTTP 429 Too Many Requests · Inbound webhook backlog full

See Event-driven workloads.

inbound_webhook_bad_signature

HTTP 400 Bad Request · Invalid webhook signature

inbound_webhook_invalid

HTTP 400 Bad Request · Invalid inbound webhook

inbound_webhook_rate_limited

HTTP 429 Too Many Requests · Inbound webhook rate limited

See Event-driven workloads.

inbound_webhook_routing_conflict

HTTP 409 Conflict · Endpoint already routed

inbound_webhook_too_large

HTTP 413 Request Entity Too Large · Webhook body too large

init_sidecar_failed

The response's title and detail describe the failure.

insights_query_timeout

HTTP 503 Service Unavailable · Analytics query timed out

instance_busy

HTTP 409 Conflict or 503 Service Unavailable · Function still running; Instance busy

insufficient_scope

HTTP 403 Forbidden · Many operations send this code; the response's title and detail name the failure.

internal

HTTP 500 Internal Server Error · List failed; Delete failed; Lookup failed

See Application companions, Networking.

internal_error

HTTP 500 Internal Server Error or 503 Service Unavailable · Many operations send this code; the response's title and detail name the failure.

invalid_autoscale_target_cpu_pct

HTTP 422 Unprocessable Entity · Invalid autoscale target CPU%

invalid_autoscale_target_rps

HTTP 422 Unprocessable Entity · Invalid autoscale target RPS

invalid_body

HTTP 400 Bad Request · Invalid JSON body

invalid_canary_preset

HTTP 422 Unprocessable Entity · Invalid canary preset; Invalid canary rollout

See Progressive rollouts.

invalid_cooldown

HTTP 422 Unprocessable Entity · Invalid cooldown

See Scaling policy.

invalid_cpu_millicores

HTTP 422 Unprocessable Entity · Invalid CPU

invalid_cpu_ram_pair

HTTP 422 Unprocessable Entity · Invalid CPU/RAM pair

See Plans and pricing.

invalid_credentials

HTTP 401 Unauthorized · Sign in failed

See Account and organization management.

invalid_cursor

HTTP 400 Bad Request · Invalid cursor

invalid_egress_allowlist

HTTP 400 Bad Request · Invalid egress allowlist entry

See Networking.

invalid_egress_port

HTTP 400 Bad Request · Invalid egress port

See Networking.

invalid_max_instances

HTTP 422 Unprocessable Entity · Invalid max_instances

See Scaling policy.

invalid_min_instances

HTTP 422 Unprocessable Entity · Invalid min_instances; Min_instances must be >= 0

See How scaling to zero works.

invalid_mirror_percent

HTTP 422 Unprocessable Entity · Invalid mirror percent

See Progressive rollouts.

invalid_mirror_window

HTTP 422 Unprocessable Entity · Invalid mirror window

See Progressive rollouts.

invalid_nonce

HTTP 400 Bad Request · Invalid OAuth Request

invalid_openapi_shape

HTTP 400 Bad Request · Doc must be a JSON object with a top-level 'openapi' or 'swagger' key

invalid_pkce

HTTP 400 Bad Request · Invalid OAuth Request

invalid_public_auth_ip_allowlist

HTTP 400 Bad Request · Invalid public-auth IP allowlist entry

See Authentication.

invalid_ram_mb

HTTP 422 Unprocessable Entity · Invalid RAM

invalid_recover_action

HTTP 422 Unprocessable Entity · Invalid recover_rollout action

See Progressive rollouts.

invalid_ref

HTTP 400 Bad Request · Invalid ref

See Deploy from a GitHub source ref.

invalid_registry_host

HTTP 400 Bad Request · Invalid registry host

See Registry credentials.

invalid_request

HTTP 400 Bad Request · Many operations send this code; the response's title and detail name the failure.

invalid_resource_profile

HTTP 422 Unprocessable Entity · Conflicting resource profile; Invalid resource profile

invalid_scheduled_at

HTTP 400 Bad Request · Invalid scheduled_at

See Event-driven workloads.

invalid_source

HTTP 400 Bad Request · Source must be one of: cold_boot, manual_upload; Source must be one of: manual_import, auto

invalid_state

HTTP 400 Bad Request · Invalid State

invalid_traffic_percent

HTTP 422 Unprocessable Entity · Invalid traffic_percent

See Progressive rollouts.

invalid_warm_pool_size

HTTP 422 Unprocessable Entity · Invalid warm_pool_size; Invalid max_concurrency for warm_pool_size

invalid_warm_snapshot_min_ms

HTTP 422 Unprocessable Entity · Invalid warm_snapshot_min_ms

invalid_warm_snapshot_min_requests

HTTP 422 Unprocessable Entity · Invalid warm_snapshot_min_requests

invocation_environment_work_isolation_unavailable

HTTP 409 Conflict · Stage work unavailable

invocation_not_found

HTTP 404 Not Found · Invocation not found

See Event-driven workloads.

invocation_not_replayable

HTTP 409 Conflict · Invocation not replayable; Invocation is not in a replayable state

See Event-driven workloads.

invocation_replay_unavailable

HTTP 409 Conflict · Invocation replay unavailable

invocation_version_conflict

HTTP 409 Conflict · Invocation version conflict

invocation_version_unavailable

HTTP 410 Gone · Invocation version unavailable

invocation_wait_interrupted

Invocation wait interrupted

See CLI guide.

invocation_wait_timeout

HTTP 408 Request Timeout · Invocation wait timed out

See CLI guide.

ip_denied

HTTP 403 Forbidden · IP address not allowed; IP denied; IP not allowed

See Edge rules, Errors.

J

job_command_invalid

HTTP 422 Unprocessable Entity · Job command invalid

See Jobs.

job_deadline_exceeded

HTTP 410 Gone · Job run deadline exceeded

See Jobs.

job_has_live_instances

HTTP 409 Conflict · Job has active work; Job has live instances

See Jobs.

job_image_missing

HTTP 422 Unprocessable Entity · Job image not found

See Jobs.

job_quota_exceeded

HTTP 403 Forbidden · Job limit reached

See Plans and pricing.

job_registry_credential_not_found

HTTP 400 Bad Request · Job registry credential not set

See Registry credentials.

job_run_cancelled

HTTP 409 Conflict · Job run is already terminal

See Jobs.

job_task_max_retries_reached

HTTP 409 Conflict · Job task retry budget exhausted

See Jobs.

job_task_not_found

HTTP 404 Not Found · Job task not found; Task not found

See Jobs.

job_task_not_retriable

HTTP 409 Conflict · Job task cannot be retried

See Jobs.

jobs_not_allowed

HTTP 402 Payment Required · Jobs unavailable on this plan

See Plans and pricing.

json_error

HTTP 500 Internal Server Error · Internal Error

jwt_audience_mismatch

HTTP 401 Unauthorized · JWT audience mismatch

jwt_missing_issuer

HTTP 401 Unauthorized · JWT issuer mismatch

jwt_missing_token

HTTP 401 Unauthorized · JWT bearer token required

jwt_signature_invalid

HTTP 401 Unauthorized · JWT signature invalid

L

log_archive_degraded

HTTP 503 Service Unavailable · Archived logs unavailable

See CLI guide.

log_archive_invalid_query

HTTP 400 Bad Request · Invalid archived log request

Choose an instance and a date formatted as YYYY-MM-DD, then retry.

See Logs, Errors.

log_archive_missing

HTTP 404 Not Found · Archived logs not found

See CLI guide.

log_archive_retention_exceeded

HTTP 403 Forbidden · Archived log date is outside the retention window

Choose a more recent date, or review plans with longer log retention.

See Logs, Errors.

log_archive_unconfigured

HTTP 503 Service Unavailable · Archived logs temporarily unavailable

Retry shortly, or use gregale logs APP for live logs.

See Logs, Errors.

log_reads_busy

HTTP 429 Too Many Requests · Too many log reads

log_streams_limit

HTTP 429 Too Many Requests · Too many log streams

See Logs.

long_poll_timeout

HTTP 503 Service Unavailable · Long-poll wait budget ran out

See Event-driven workloads.

M

managed_postgres_ambiguous

HTTP 409 Conflict · Managed PostgreSQL database reference is ambiguous

managed_postgres_binding_changed

HTTP 409 Conflict · Gregale.yaml changes an existing binding

Bind the new database or access under another env key and switch the app to it, or delete the old binding (gregale postgres bindings) and deploy again.

See Managed PostgreSQL.

managed_postgres_binding_limit

HTTP 403 Forbidden · Managed PostgreSQL binding limit reached

Delete a binding the app no longer uses (gregale postgres bindings delete) or upgrade the plan.

See Plans and pricing.

managed_postgres_binding_not_ready

HTTP 409 Conflict · Managed PostgreSQL binding is not ready

managed_postgres_binding_target_missing

HTTP 409 Conflict · Database binding target missing

managed_postgres_forbidden

HTTP 403 Forbidden · Cannot create managed PostgreSQL database

managed_postgres_not_found

HTTP 404 Not Found · Managed PostgreSQL database not found; Managed PostgreSQL resource not found

managed_postgres_not_in_plan

HTTP 403 Forbidden · Managed PostgreSQL is not included in this plan

managed_postgres_not_ready

HTTP 409 Conflict · Managed PostgreSQL database is not ready

managed_postgres_plan_unknown

HTTP 422 Unprocessable Entity · Managed PostgreSQL plan unknown

managed_postgres_quota_exceeded

HTTP 403 Forbidden · Managed PostgreSQL quota exceeded

Delete a database you no longer need or upgrade the plan, then try again; or restore the database with gregale postgres restore and attach the copy yourself.

See Plans and pricing, Managed PostgreSQL, Safe releases.

managed_postgres_unavailable

HTTP 503 Service Unavailable · Managed PostgreSQL unavailable

See Managed PostgreSQL.

max_min_instances_exceeded

HTTP 422 Unprocessable Entity · Min_instances exceeds plan cap

See How scaling to zero works.

method_not_allowed

HTTP 405 Method Not Allowed · MCP instance probe failed; Method not allowed; Routes read failed

mfa_disable_cooldown

HTTP 425 Too Early · MFA disable cooldown active

mfa_invalid_code

HTTP 401 Unauthorized · Invalid code; Invalid credentials; Invalid token

mfa_last_recovery_code

HTTP 409 Conflict · Last recovery code

mfa_required

HTTP 403 Forbidden or 409 Conflict · MFA required; MFA setup incomplete; Session required

migration_recovery_blocked

HTTP 409 Conflict · Migration recovery blocked

mirror_cross_app_mismatch

HTTP 422 Unprocessable Entity · Source and mirror deployments must belong to the same app

See Progressive rollouts.

mirror_deployment_not_live

HTTP 409 Conflict · Referenced deployment is not live

See Progressive rollouts.

mirror_rule_not_found

HTTP 404 Not Found · Mirror rule not found

See Progressive rollouts.

mirror_rule_quota_exceeded

HTTP 422 Unprocessable Entity · Mirror rule quota exceeded

See Progressive rollouts.

mirror_slot_at_capacity

HTTP 503 Service Unavailable

mirror_source_target_same

HTTP 422 Unprocessable Entity · Source and mirror deployments must differ

See Progressive rollouts.

misdirected_request

HTTP 421 Misdirected Request · Misdirected request

missing_code

HTTP 400 Bad Request · Authorization Error

missing_doc

HTTP 400 Bad Request · Doc field is empty; Set_doc=true with a non-empty doc is required

N

no_live_deployment

HTTP 409 Conflict · App has no live deployment; No live deployment

See CLI guide.

no_rollback_target

HTTP 409 Conflict · A release is still rolling out; Choose a rollback target; More than one environment serves this app

See Deploys.

not_found

HTTP 404 Not Found or 410 Gone · Many operations send this code; the response's title and detail name the failure.

notification_channel_in_use

HTTP 409 Conflict · Channel has open incidents; Notification channel in use

See Alerts.

notification_channel_invalid

HTTP 400 Bad Request or 409 Conflict · Channel name already exists; Invalid notification channel

See Alerts.

notification_channel_limit_reached

HTTP 422 Unprocessable Entity · Notification channel limit reached

See Alerts.

notification_channel_test_rate_limited

HTTP 429 Too Many Requests · Notification channel test rate limited

See Alerts.

O

oauth_exchange_failed

HTTP 400 Bad Request or 503 Service Unavailable · OAuth Failed

oauth_provider_unavailable

HTTP 503 Service Unavailable · GitHub connection unavailable; OAuth Provider Unavailable

Try again later, or contact support if you need to connect GitHub.

Use another sign-in method, or contact support if you need this provider.

See Authentication, Errors.

obs_runtime_busy

HTTP 429 Too Many Requests · Runtime collection busy

See Errors.

openapi_docs_not_allowed

HTTP 402 Payment Required · Endpoint discovery unavailable on this plan; Stored route checks unavailable

See Plans and pricing.

openapi_import_invalid

HTTP 422 Unprocessable Entity or 500 Internal Server Error · Persisted OpenAPI document could not be analyzed; Failed to walk imported doc for dry-run; Imported OpenAPI doc failed validation

openapi_import_quota_reached

HTTP 403 Forbidden · Per-account OpenAPI import quota reached

openapi_import_too_large

HTTP 413 Request Entity Too Large · Imported doc exceeds size cap

openapi_import_too_many_endpoints

HTTP 422 Unprocessable Entity · Imported doc declares too many endpoints

openapi_policy_confirmation_required

HTTP 400 Bad Request · OpenAPI policy confirmation is required

openapi_policy_stale

HTTP 409 Conflict · OpenAPI policy plan is stale

org_already_member

HTTP 409 Conflict · Already a member of this organization

See Account and organization management.

org_api_key_requires_org

HTTP 409 Conflict · Organization key required; API key must be bound to an organization; Organization project path required

See Account and organization management.

org_free_limit_exceeded

HTTP 403 Forbidden · Free organization limit reached

See Account and organization management.

org_invitation_cap_exceeded

HTTP 403 Forbidden · Organization invitation limit reached

See Account and organization management.

org_invitation_expired

HTTP 410 Gone · Invitation expired

See Account and organization management.

org_invitation_invalid

HTTP 410 Gone · Invitation invalid

See Account and organization management.

org_last_owner

HTTP 409 Conflict · Cannot remove the last owner; Owner cannot leave

See Account and organization management.

org_member_cap_exceeded

HTTP 403 Forbidden · Organization member limit reached

See Account and organization management.

org_mfa_required

HTTP 403 Forbidden or 409 Conflict · Turn on two-factor authentication first; Two-factor authentication required

See Account and organization management.

org_not_found

HTTP 404 Not Found · Organization not found

See Account and organization management.

org_personal_immutable

HTTP 409 Conflict · Personal organizations are immutable

See Account and organization management.

org_role_forbidden

HTTP 403 Forbidden · Application standards mutation forbidden; Approver not allowed; Insufficient role for this action

Ask a teammate the policy lets approve to approve this promotion, then promote with their approval.

See Account and organization management, Deploys.

org_slug_invalid

HTTP 422 Unprocessable Entity · Invalid org plan; Invalid organization slug

See Account and organization management.

org_slug_taken

HTTP 409 Conflict · Organization slug in use

See Account and organization management.

outbound_probe_unavailable

The response's title and detail describe the failure.

See Errors.

overage_cap_above_max

HTTP 422 Unprocessable Entity · Spend cap above plan maximum

See Billing.

overage_cap_required

HTTP 422 Unprocessable Entity · Spend cap required

See Billing.

P

password_too_weak

HTTP 400 Bad Request · Password too weak

See Account and organization management.

payment_authentication_required

HTTP 402 Payment Required · Bank confirmation required

See Billing.

payment_required

HTTP 402 Payment Required · Billing confirmation required; Upgrade not charged; Billing subscription required

penalty_box

HTTP 403 Forbidden · Temporarily blocked

See Edge rules, Security.

plan_alert_presets_not_allowed

HTTP 402 Payment Required · Alert preset not available on this plan

See Plans and pricing.

plan_alert_rule_quota

HTTP 403 Forbidden · Alert rule limit reached

See Plans and pricing.

plan_alert_rules_not_allowed

HTTP 402 Payment Required · Alert rules unavailable on this plan

See Plans and pricing.

plan_app_errors_not_allowed

HTTP 402 Payment Required · App error grouping unavailable on this plan

See Plans and pricing.

plan_app_protocol_grpc_not_allowed

HTTP 403 Forbidden · Per-app gRPC wire protocol is not allowed on this plan

plan_app_usage_summary_not_allowed

HTTP 402 Payment Required · App usage summary unavailable on this plan

See Plans and pricing.

plan_async_backlog

HTTP 429 Too Many Requests · Per-app async backlog full

See Event-driven workloads.

plan_autoscale_not_allowed

HTTP 403 Forbidden · Autoscale target CPU% is not allowed on this plan; Autoscale target RPS is not allowed on this plan

plan_cors_preset_quota_reached

HTTP 403 Forbidden · CORS preset limit reached

See Plans and pricing.

plan_cors_presets_not_allowed

HTTP 402 Payment Required · CORS presets unavailable on this plan

See Plans and pricing.

plan_cron_quota

HTTP 403 Forbidden · Cron limit reached; Cron over plan limit

See Crons.

plan_crons_not_allowed

HTTP 402 Payment Required · Crons unavailable on this plan

See Crons.

plan_custom_metrics_not_allowed

HTTP 402 Payment Required · Custom metrics not available on this plan

plan_delayed_tasks_cap

HTTP 403 Forbidden · Per-app delayed-task cap exceeded

See Event-driven workloads.

plan_edge_rule_kind_not_allowed

HTTP 402 Payment Required · Edge rule kind unavailable on this plan

See Edge rules.

plan_edge_rule_kind_quota_reached

HTTP 403 Forbidden · Edge rule kind quota reached

See Edge rules.

plan_egress_allowlist_not_allowed

HTTP 403 Forbidden · Plan doesn't allow an egress allowlist

See Networking.

plan_egress_overage_not_allowed

HTTP 402 Payment Required · Plan cannot elect egress overage

See Billing.

plan_egress_ports_not_allowed

HTTP 403 Forbidden · Plan doesn't allow extra egress ports

See Networking.

plan_empty

HTTP 422 Unprocessable Entity · Project plan is empty

plan_eviction_priority_reserved_not_allowed

HTTP 402 Payment Required · Reserved eviction priority is not available on this plan

See Plans and pricing.

plan_eviction_priority_reserved_quota

HTTP 422 Unprocessable Entity · Reserved eviction priority quota reached

See Plans and pricing.

plan_feature_gated

HTTP 402 Payment Required · Many operations send this code; the response's title and detail name the failure.

plan_feature_unavailable

HTTP 403 Forbidden · Bucket triggers unavailable

plan_gate_blocked

HTTP 403 Forbidden · Plan gate blocked

plan_health_path_wakes_not_allowed

HTTP 403 Forbidden · Health-path wakes are not allowed on this plan

plan_inbound_webhook_quota

HTTP 403 Forbidden · Inbound webhook endpoint limit reached

See Event-driven workloads.

plan_inbound_webhooks_not_allowed

HTTP 402 Payment Required · Inbound webhooks unavailable on this plan

See Event-driven workloads.

plan_internal_ingress_not_allowed

HTTP 402 Payment Required · Plan does not unlock internal-only ingress

See Networking.

plan_job_registry_credential_quota

HTTP 413 Request Entity Too Large · Per-job registry credential quota reached

See Registry credentials.

plan_job_registry_credentials_not_allowed

HTTP 403 Forbidden · Plan doesn't allow private-registry credentials for jobs

See Registry credentials.

plan_limit_apps

HTTP 403 Forbidden · App limit reached; Environment branch limit reached; PR preview environment too large

See Plans and pricing.

plan_limit_build_minutes

HTTP 403 Forbidden · Build minutes used up

See Plans and pricing.

plan_limit_concurrency

HTTP 403 Forbidden or 429 Too Many Requests · Concurrency limit reached; Concurrency over plan limit; Execution concurrency limit reached

See Plans and pricing, Gregale API specification.

plan_limit_deployment_aliases

HTTP 403 Forbidden · Deployment alias limit reached

See Deploys.

plan_limit_developer_apps

HTTP 403 Forbidden · Developer environment limit reached

See Plans and pricing.

plan_limit_developer_lease

HTTP 403 Forbidden · Developer environment lease over plan limit

See Plans and pricing, gregale dev.

plan_limit_edge_rule_list_items

HTTP 403 Forbidden · Edge rule list too large

See Edge rules.

plan_limit_edge_rule_lists

HTTP 403 Forbidden · Edge rule list limit reached

See Edge rules.

plan_limit_edge_rules

HTTP 403 Forbidden · Edge rule limit reached

See Edge rules.

plan_limit_env_vars

HTTP 403 Forbidden · Env var count limit reached

See Environment variables.

plan_limit_project_secrets

HTTP 403 Forbidden · Project secret limit reached

See Delivered secrets.

plan_limit_ram

HTTP 403 Forbidden · RAM over plan limit

See Plans and pricing.

plan_limit_secrets

HTTP 403 Forbidden · Secret count limit reached

See Delivered secrets.

plan_limit_trusted_signers

HTTP 403 Forbidden · Trusted signer count limit reached; Trusted signers are not allowed on this plan

See Security.

plan_liveness_probe_not_allowed

HTTP 403 Forbidden · GRPC liveness probes are not allowed on this plan; Liveness probes are not allowed on this plan; Plan doesn't allow a liveness probe

See Deployment overrides.

plan_log_archive_not_allowed

HTTP 402 Payment Required · Log archive unavailable on this plan

See Logs.

plan_log_drain_quota

HTTP 403 Forbidden · Log drain limit reached

See Logs.

plan_log_drains_not_allowed

HTTP 402 Payment Required · Log drains unavailable on this plan

See Logs.

plan_max_instances_not_allowed

HTTP 403 Forbidden · Plan doesn't allow a max_instances ceiling

See Scaling policy.

plan_min_instances_not_allowed

HTTP 403 Forbidden · Plan doesn't allow a min-instances floor

See How scaling to zero works.

plan_mirror_not_allowed

HTTP 403 Forbidden · Plan doesn't allow traffic mirroring

See Progressive rollouts.

plan_openapi_doc_quota_reached

HTTP 403 Forbidden · OpenAPI document limit reached

See Plans and pricing.

plan_openapi_doc_too_large

HTTP 413 Request Entity Too Large · OpenAPI document exceeds the per-plan byte cap

See Plans and pricing.

plan_per_app_metrics_not_allowed

HTTP 402 Payment Required · Per-app metrics unavailable on this plan

See Plans and pricing.

plan_private_network_not_allowed

HTTP 402 Payment Required · Plan does not unlock private network attachments

See Networking.

plan_public_auth_basic_not_allowed

HTTP 402 Payment Required · Basic public-URL auth is not available on this plan

See Authentication.

plan_public_auth_bearer_not_allowed

HTTP 402 Payment Required · Bearer public-URL auth is not available on this plan

See Authentication.

plan_public_auth_ip_allowlist_not_allowed

HTTP 403 Forbidden · Plan doesn't allow a public-auth IP allowlist

See Authentication.

plan_queue_backlog_bytes

HTTP 403 Forbidden · Account queue backlog full

See Event-driven workloads.

plan_queue_depth

HTTP 403 Forbidden · Per-app queue depth exceeded

See Event-driven workloads.

plan_registry_credential_quota

HTTP 413 Request Entity Too Large · Per-app registry credential quota reached

See Registry credentials.

plan_registry_credentials_not_allowed

HTTP 403 Forbidden · Plan doesn't allow private-registry credentials

See Registry credentials.

plan_reorder_disabled

HTTP 402 Payment Required · Plan doesn't allow reorder or deploy-immediately

Cancel + clear-obsolete remain available on Free; upgrade to unlock reorder/deploy-immediately.

See Plans and pricing.

plan_require_authn_not_allowed

HTTP 403 Forbidden · Per-app authentication is not allowed on this plan; Per-deployment authentication is not allowed on this plan

plan_rollback_on_5xx_not_allowed

HTTP 403 Forbidden · Plan doesn't allow 5xx auto-rollback

See Plans and pricing.

plan_route_metrics_not_allowed

HTTP 403 Forbidden · Per-route metrics are not allowed on this plan

plan_source_bytes

HTTP 413 Request Entity Too Large · Invocation payload too large

See Event-driven workloads.

plan_static_egress_ip_not_allowed

HTTP 402 Payment Required · Plan does not unlock static egress IP

See Static egress IP.

plan_static_egress_ip_quota

HTTP 403 Forbidden · Static egress IP quota reached

See Static egress IP.

plan_streaming_not_allowed

HTTP 403 Forbidden · Streaming responses are not allowed on this plan

plan_token_stale

HTTP 409 Conflict · Plan_token does not match project binding; Plan_token does not match uploaded source; Project selection changed after review

plan_traffic_split_not_allowed

HTTP 403 Forbidden · Plan doesn't allow traffic splitting; Route enforcement unavailable; Route health enforcement unavailable

See Plans and pricing.

plan_trigger_quota

HTTP 403 Forbidden · Trigger limit reached

See Plans and pricing.

plan_triggers_not_allowed

HTTP 402 Payment Required · Triggers unavailable on this plan

See Plans and pricing.

plan_warm_pool_not_allowed

HTTP 403 Forbidden · Warm-pool capacity is not allowed on this plan

plan_warm_snapshot_not_allowed

HTTP 403 Forbidden · Warm-tier snapshots are not allowed on this plan

plan_webhook_quota

HTTP 403 Forbidden · Webhook limit reached

See Plans and pricing.

plan_webhooks_not_allowed

HTTP 402 Payment Required · Outbound webhooks unavailable on this plan

See Plans and pricing.

plan_websocket_not_allowed

HTTP 403 Forbidden · WebSocket / Upgrade traffic is not allowed on this plan

plan_workflows_not_allowed

HTTP 402 Payment Required · Workflows unavailable on this plan

See Plans and pricing.

plan_workflows_quota

HTTP 403 Forbidden · Stored workflow definition quota exceeded; Workflow run quota exceeded

See Plans and pricing.

platform_release_paused

HTTP 503 Service Unavailable · Releases are paused

See Release approvals, freezes and schedules.

postgres_custom_roles_limit

HTTP 409 Conflict · Custom role limit reached

Delete a role you no longer need (gregale postgres roles delete).

postgres_custom_roles_unavailable

HTTP 403 Forbidden · Postgres custom roles unavailable

postgres_custom_roles_unsupported

HTTP 422 Unprocessable Entity · Custom roles unsupported

pr_preview_resource_unsupported

HTTP 409 Conflict

Give previews test credentials in the production app's pr-preview scope: gregale env set --app <app> --env pr-preview KEY=value

See PR preview environments.

preflight_busy

Preflight is busy

preflight_check_failed

Check failed

preflight_invalid_source

Not a GitHub repository; Invalid ref

preflight_rate_limited

Too many checks

preflight_repo_not_found

Repository not found

preflight_source_too_large

Repository too large

preflight_upstream_unavailable

GitHub is rate limiting us

preview_environment_not_found

HTTP 404 Not Found · Preview environment not found

preview_expired

HTTP 410 Gone · Review source again; Review this project again; Preview source expired

preview_full

HTTP 409 Conflict · Preview is full

See CLI guide.

preview_not_found

HTTP 404 Not Found · Preview not found

preview_not_offered

HTTP 404 Not Found · Preview not offered

See CLI guide.

preview_org_unsupported

HTTP 409 Conflict · Preview cannot be joined by an organization

See CLI guide.

preview_plan_not_eligible

HTTP 403 Forbidden · Plan not eligible for this preview

See CLI guide.

preview_production_dependency_denied

HTTP 403 Forbidden · Preview dependency denied

See Internal services, PR preview environments.

private_invocation_disabled

HTTP 503 Service Unavailable · Private invocation unavailable

private_network_fabric_unavailable

Private network fabric unavailable

private_network_invalid

HTTP 400 Bad Request · Invalid private network attachment

See Networking.

private_network_not_enabled

HTTP 503 Service Unavailable · Private network attachments are not enabled on this cluster

See Networking.

private_network_transport_unavailable

Private network transport unavailable

private_network_unavailable

Private network firewall updates unavailable; Private network policy updates unavailable; Private network attachment updates unavailable

private_publication_disabled

HTTP 503 Service Unavailable · Private publication unavailable

prod_branch_mismatch

HTTP 409 Conflict · Production branch does not match the existing project

project_apply_stale

HTTP 409 Conflict · Project changed during apply

project_configuration_failed

HTTP 503 Service Unavailable · Project configuration incomplete

project_environment_approval_invalid

HTTP 409 Conflict · Many operations send this code; the response's title and detail name the failure.

project_environment_approval_required

HTTP 409 Conflict · Protected environment; Protected environment approval required

Change it in the source environment and promote, or run gregale project apply and approve the plan. Deleting or rotating a secret stays open for incident response.

Run gregale project apply or gregale project promote and approve the plan, or deploy with no traffic to stage the release.

project_promotion_queue_full

HTTP 429 Too Many Requests · Promotion queue is full

See Deploys, Environment promotion.

project_release_baseline_expired

HTTP 410 Gone · Rollback baseline expired

See Atomic project releases.

project_release_control_conflict

HTTP 409 Conflict · Deployment control conflicted

project_release_rollback_required

HTTP 409 Conflict · Project release rollback required

Roll back the project environment release, then retry this app rollback if needed.

project_release_secrets_pinned

HTTP 409 Conflict · Secret versions are release-bound

Bind the bucket in an environment whose release does not pin secrets, or release without pinned secrets first.

Bind the database in an environment whose release does not pin secrets, or release without pinned secrets first.

See Delivered secrets.

project_required

HTTP 409 Conflict · Project required

project_retry_changed

HTTP 409 Conflict · Project retry stopped

project_selection_empty

HTTP 409 Conflict · No workloads selected

See Deploy a multi-service app.

project_services_call_each_other

HTTP 409 Conflict · Project services call each other

Delete the services instead (gregale app delete), or pass detach_services=true (gregale project delete --detach-services) once they no longer call each other by name.

project_submission_exists

HTTP 409 Conflict · Project submission already registered

project_submission_mismatch

HTTP 409 Conflict · Project submission intent changed

promotion_rolled_back

The response's title and detail describe the failure.

provision_capacity

HTTP 429 Too Many Requests · Provisioning capacity reached

public_auth_config_invalid

HTTP 503 Service Unavailable · Public authentication unavailable

public_auth_ip_allowlist_too_long

HTTP 400 Bad Request · Public-auth IP allowlist too long

See Authentication.

Q

queue_binding_environment_unavailable

HTTP 409 Conflict · Queue environment unavailable

queue_binding_keyed_work

HTTP 409 Conflict · Keyed work still queued

queue_binding_retired

HTTP 409 Conflict · Queue binding retired

queue_canary_changed

HTTP 409 Conflict · Queue canary blocked

queue_environment_work_policy_unavailable

HTTP 409 Conflict · Scoped work policy unavailable

queue_groups_unavailable

HTTP 403 Forbidden · Ordered message groups unavailable

queue_message_not_processed

HTTP 409 Conflict · Queue message not processed

queue_receive_busy

HTTP 429 Too Many Requests · Too many queue receives in flight

See Errors.

queue_replay_requires_binding

HTTP 409 Conflict · Queue replay requires its binding

quota_exhausted

HTTP 429 Too Many Requests · Custom domain quota reached; Domain verification rate limited; Profile capture limit reached

See Gregale API specification.

R

rate_limit_unavailable

HTTP 503 Service Unavailable · Request admission unavailable

rate_limited

HTTP 429 Too Many Requests · Rate limit exceeded; Pre-auth rate limit exceeded

See Edge rules.

realtime_unavailable

HTTP 503 Service Unavailable · Managed realtime temporarily unavailable

Retry the connection in a few seconds.

See Plans and pricing, Errors.

recent_sign_in_required

HTTP 403 Forbidden · Sign in again

See Authentication, Account and organization management.

registry_credential_not_found

HTTP 400 Bad Request · Registry credential not set

See Registry credentials.

regression_changed

HTTP 409 Conflict · Regression changed

release_approval_canary_required

HTTP 409 Conflict · Release approvals need a canary; Release approvals need an approved promotion

Deploy with --rollout safe or fast (or without --rollout immediate and --traffic-percent), or remove the policy with gregale release approval disable.

See Deploys, Release approvals, freezes and schedules.

release_approval_decided

HTTP 409 Conflict · Decision not accepted

release_approval_policy_not_found

HTTP 404 Not Found · No approval policy

release_approval_rejected

HTTP 409 Conflict · Release rejected

Deploy a new release; a rejection is final.

See Deploys.

release_approval_required

HTTP 409 Conflict · Release waiting for approval

An eligible teammate approves it on its approval page in the dashboard; the rollout then continues on its next tick.

See Deploys.

release_approval_self

HTTP 403 Forbidden · Approve someone else's promotion; Self-approval not allowed

Ask an eligible teammate to approve it on the release's approval page in the dashboard.

Ask another approver to approve this promotion, then promote with their approval.

See Deploys.

release_approval_session_required

HTTP 403 Forbidden · Approve as a person; Approve in the dashboard

Approve the promotion signed in as yourself, not with an API key or token, then promote with that approval.

See Deploys.

release_command_failed

HTTP 422 Unprocessable Entity

See Safe releases.

release_freeze_limit

HTTP 409 Conflict · Too many freezes

Lift freezes you no longer need with gregale release freeze lift.

See Deploys.

release_freeze_not_found

HTTP 404 Not Found · Freeze not found

List freezes with gregale release freeze list. A company's freezes are lifted with --org ORG, or --app APP for a freeze on one app.

release_freeze_override_not_allowed

HTTP 403 Forbidden · Freeze override not allowed

Ask an owner or admin to lift the freeze with gregale release freeze lift, or to deploy with --override-freeze.

See Deploys.

release_frozen

HTTP 409 Conflict · Production releases are frozen

Wait for the freeze to end, lift it with gregale release freeze lift, or release anyway with override_freeze and a reason (CLI: --override-freeze REASON); the override is audited.

See Deploys, Release approvals, freezes and schedules.

release_gate_limit

HTTP 409 Conflict · Too many release gates

Delete a gate you no longer need with gregale release gate rm.

See Deploys.

release_gate_not_found

HTTP 404 Not Found · Release gate not found

List gates with gregale release gate list.

release_graph_changed

HTTP 409 Conflict · Active graph required; History unavailable; Release graph changed

release_infrastructure_failed

The response's title and detail describe the failure.

See Deploys, Safe releases.

release_not_parked

HTTP 409 Conflict · Release cannot be scheduled

release_outcome_uncertain

HTTP 422 Unprocessable Entity

See Safe releases.

release_phase_unavailable

HTTP 422 Unprocessable Entity · Release commands unavailable

release_scheduled

HTTP 409 Conflict · Release is scheduled

See Release approvals, freezes and schedules.

release_staging_changed

HTTP 409 Conflict · Release staging changed

request_body_read_failed

HTTP 400 Bad Request · Request body could not be read

See Functions and runtimes.

request_budget_exceeded

HTTP 503 Service Unavailable · Request budget exceeded; Request timed out

See Edge rules, Errors.

request_too_large

HTTP 413 Request Entity Too Large · Event too large; MCP instance probe failed; Request body too large

For larger uploads, use a bucket signed URL (gregale storage ... signed-url).

See Event-driven workloads, Plans and pricing, Storage.

request_upload_timeout

HTTP 408 Request Timeout · Request upload timed out

Retry on a stable connection, or use a bucket signed URL for large uploads.

See Functions and runtimes.

request_validation_failed

HTTP 422 Unprocessable Entity · Invalid request

See Edge rules.

reset_token_expired

HTTP 410 Gone · Reset link expired

See Account and organization management.

reset_token_invalid

HTTP 410 Gone · Reset link invalid

See Account and organization management.

response_too_large

HTTP 413 Request Entity Too Large · Response exceeded plan cap

rollback_attempt_accepted

HTTP 409 Conflict · Rollback already accepted

rollback_attempt_conflict

HTTP 409 Conflict · Rollback attempt conflict

rollback_crosses_release

HTTP 409 Conflict · Rollback crosses release commands

If the target is compatible with those changes, retry with acknowledge_releases (CLI: --acknowledge-releases). To undo database changes first, restore each listed database to its restore point.

See Deploys, Safe releases.

rollback_deployment_changed

HTTP 409 Conflict · Rollback selection changed; Serving release changed

rollback_operation_required

HTTP 409 Conflict · Checked rollback in progress

rollback_target_already_live

HTTP 409 Conflict · Rollback target is already live

See Deploys.

rollback_target_database_restored

HTTP 409 Conflict · Rollback target's database changes were undone; Rollback target's migration was undone

Deploy that code again; its release command runs before it serves.

See Deploys, Safe releases.

rollback_target_ineligible

HTTP 409 Conflict · Rollback target is not eligible

See Deploys.

rollback_target_not_found

HTTP 404 Not Found · Rollback target not found

See Deploys.

rollback_target_unavailable

HTTP 409 Conflict · Rollback target is unavailable

See Deploys.

rollout_not_stuck

HTTP 409 Conflict · Rollout is not stuck

See Progressive rollouts.

rollout_state_invalid

HTTP 409 Conflict · Rollout state does not permit recovery; Rollouts are in progress in more than one environment

See Progressive rollouts.

route_health_blocked

HTTP 409 Conflict · Route health gate blocked

S

safe_release_unavailable

HTTP 503 Service Unavailable · Safe release unavailable

scaling_request_conflict

HTTP 409 Conflict · Scaling request ID reused

scaling_revision_conflict

HTTP 409 Conflict · Scaling settings changed

scaling_target_incompatible_with_workload_class

HTTP 422 Unprocessable Entity · Target metric is not compatible with this app's workload class

See Scaling policy.

scan_critical

HTTP 503 Service Unavailable · Many operations send this code; the response's title and detail name the failure.

scheduled_release_not_found

HTTP 404 Not Found · No scheduled release

scope_exclusion_not_found

HTTP 404 Not Found · No persisted exclusion matches

secret_entry_unavailable

HTTP 410 Gone · Secret entry unavailable

secret_invalid_key

HTTP 400 Bad Request · Invalid secret key

See Delivered secrets.

secret_not_found

HTTP 400 Bad Request · Secret not set; Secret unavailable

See Delivered secrets.

secret_reference_conflict

HTTP 409 Conflict · Reference conflict

secret_reference_suppression_limit

HTTP 403 Forbidden · Suppression limit reached

See Environment variables.

secret_scan_strict

HTTP 422 Unprocessable Entity · Secret-shaped values found in uploaded source

See Delivered secrets.

secret_store_unavailable

HTTP 503 Service Unavailable · Secret storage unavailable

secret_value_too_large

HTTP 413 Request Entity Too Large · Secret value too large

See Delivered secrets.

security_posture_blocked

HTTP 403 Forbidden or 409 Conflict or 503 Service Unavailable · App is security quarantined; Security posture blocks this deploy

See Security.

security_quarantine_recovery_blocked

HTTP 409 Conflict · Security quarantine recovery is blocked

See Security.

security_scan_blocked

HTTP 422 Unprocessable Entity

service_abort_attempt_accepted

HTTP 409 Conflict · Service abort already accepted

service_abort_attempt_conflict

HTTP 409 Conflict · Service abort attempt conflict

service_recovery_capacity_unavailable

HTTP 503 Service Unavailable · Service recovery capacity unavailable

session_expired

HTTP 401 Unauthorized · Session expired; Sign in to verify

session_invalid

HTTP 401 Unauthorized · Session invalid

sidecar_cap_exceeded

HTTP 400 Bad Request · Too many sidecars

See Application companions.

sidecar_invalid_cpu_millicores

HTTP 400 Bad Request · Invalid sidecar cpu_millicores

sidecar_invalid_disk_io_profile

HTTP 400 Bad Request · Invalid sidecar disk_io_profile

sidecar_invalid_image

HTTP 400 Bad Request · Invalid sidecar image

sidecar_invalid_name

HTTP 400 Bad Request · Invalid sidecar name

sidecar_invalid_port

HTTP 400 Bad Request · Invalid sidecar port

sidecar_invalid_ram_mb

HTTP 400 Bad Request · Invalid sidecar ram_mb

sidecar_invalid_scratch_mb

HTTP 400 Bad Request · Invalid sidecar scratch_mb

sidecar_invalid_type

HTTP 400 Bad Request · Invalid sidecar type

sidecar_not_allowed_on_plan

HTTP 403 Forbidden · Plan doesn't allow sidecars

See Plans and pricing.

sidecar_stateful_denied

HTTP 403 Forbidden · Stateful sidecar image is not allowed

See Application companions.

snapshot_backoff

HTTP 503 Service Unavailable · Snapshot temporarily unavailable

snapshot_unavailable

HTTP 410 Gone · Snapshot unavailable

source_invalid

HTTP 400 Bad Request or 409 Conflict · Many operations send this code; the response's title and detail name the failure.

source_ref_stale

HTTP 409 Conflict · Repository changed; Source ref is stale

See Deploy from a GitHub source ref.

source_ref_unavailable

HTTP 503 Service Unavailable · Source-ref fetch unavailable

See Deploy from a GitHub source ref.

source_too_large

HTTP 413 Request Entity Too Large · Source too large; Entry too large

See Builds and framework detection.

stage_dependency_restore_failed

The response's title and detail describe the failure.

stage_image_build_oom

The response's title and detail describe the failure.

stage_image_build_timeout

The response's title and detail describe the failure.

stage_readiness_failed

The response's title and detail describe the failure.

stage_security_scan_findings

The response's title and detail describe the failure.

stage_snapshot_prepare_timeout

HTTP 422 Unprocessable Entity · Snapshot prime exceeded the scheduler deadline

stage_source_download_failed

The response's title and detail describe the failure.

stateless_only_violation

HTTP 422 Unprocessable Entity · Stateless-only platform

See Storage.

statement_invoice_export_in_progress

HTTP 409 Conflict · Statement invoice export in progress

static_egress_ip_not_enabled

HTTP 402 Payment Required · Static egress IP feature is not enabled on this cluster

See Static egress IP.

static_egress_ip_not_provisioned

HTTP 404 Not Found · Static egress IP not provisioned on this host

See Static egress IP.

step_up_required

HTTP 403 Forbidden · Step-up required

streaming_not_available

HTTP 413 Request Entity Too Large · Streaming response exceeded plan cap

synthetic_check_invalid

HTTP 400 Bad Request or 409 Conflict · App is internal; Invalid synthetic check; Synthetic check name already exists

See Synthetic checks.

synthetic_check_limit_reached

HTTP 422 Unprocessable Entity · Synthetic check limit reached

See Synthetic checks.

T

traffic_change_during_canary

HTTP 409 Conflict · Canary rollout controls traffic

See Progressive rollouts.

traffic_deadline_invalid

The response's title and detail describe the failure.

traffic_deadline_unavailable

The response's title and detail describe the failure.

traffic_percent_sum_invalid

HTTP 409 Conflict · No deployment can take the remaining traffic; Traffic_percent sum invariant violated

See Progressive rollouts, Deploys.

traffic_policy_too_complex

HTTP 422 Unprocessable Entity · Traffic policy analysis limit reached

See Edge rules.

traffic_policy_too_large

HTTP 422 Unprocessable Entity · Traffic policy too large

Reduce policy values and replace the policy. Clear an environment overlay or disable and clear its scoped route contract to recover it.

Reduce rules or preset values that match the same host. Size-reducing repairs to an existing oversized host remain allowed.

See Edge rules.

traffic_policy_unavailable

HTTP 503 Service Unavailable · Traffic policy unavailable

See Edge rules.

traffic_revocation_unavailable

HTTP 503 Service Unavailable · Traffic security verification unavailable

traffic_revoked

HTTP 403 Forbidden · Traffic revoked

traffic_serving_changed

HTTP 409 Conflict · Production revision changed; Traffic split changed

See Progressive rollouts.

traffic_split_release_limit

HTTP 422 Unprocessable Entity · Too many releases in the traffic split

See Progressive rollouts, Deploys.

transport_error

HTTP 503 Service Unavailable · Could not reach Gregale

See Errors.

trigger_batch_window_too_large

HTTP 403 Forbidden · Batch_window too large for this plan

See Plans and pricing.

trigger_immutable

HTTP 400 Bad Request · Binding is immutable; Kind=cron not supported on POST /v1/triggers — use POST /v1/crons

trigger_inconsistent

HTTP 500 Internal Server Error · Trigger has no cron_id

trigger_invalid_config

HTTP 422 Unprocessable Entity · Many operations send this code; the response's title and detail name the failure.

trigger_invalid_retry_policy

HTTP 422 Unprocessable Entity · Invalid retry policy

trigger_kind_not_allowed

HTTP 403 Forbidden · Trigger kind not available

See Plans and pricing.

trigger_kind_unavailable

HTTP 422 Unprocessable Entity · Trigger kind unavailable

trigger_tls_skip_verify_not_allowed

HTTP 403 Forbidden · Tls.skip_verify unavailable on this plan

See Plans and pricing.

trusted_signer_invalid

HTTP 400 Bad Request · Trusted signer invalid

See Security.

trusted_signer_not_found

HTTP 404 Not Found · Trusted signer not found

U

udp_listener_limit

HTTP 409 Conflict · UDP listener reservation limit reached

See Networking.

unauthorized

HTTP 401 Unauthorized · Many operations send this code; the response's title and detail name the failure.

unavailable

Migration unavailable

See Apps, Billing, Jobs from the CLI.

undo_plan_changed

HTTP 409 Conflict · Undo plan changed

undo_too_many_changes

HTTP 422 Unprocessable Entity · Too many changes

unsupported_by_cli

HTTP 403 Forbidden · Endpoint requires the dashboard session cookie

See CLI guide.

unsupported_media_type

HTTP 415 Unsupported Media Type · Unsupported media type

See Edge rules.

upload_checksum_mismatch

HTTP 410 Gone · Uploaded archive does not match its checksum

Start the upload again; gregale deploy does this automatically.

See Deploys.

upload_session_already_cancelled

HTTP 409 Conflict · Upload session not open

See Deploys.

upload_session_already_committed

HTTP 409 Conflict · Upload session already committed

See Deploys.

upload_session_expired

HTTP 410 Gone · Upload session expired

See Deploys.

upload_session_not_found

HTTP 404 Not Found · Upload session not found

See Deploys.

upload_session_offset_conflict

HTTP 409 Conflict · Upload session offset conflict

See Deploys.

upload_session_too_many

HTTP 429 Too Many Requests · Too many upload sessions

See Deploys.

V

validation_failed

HTTP status varies by operation · Many operations send this code; the response's title and detail name the failure.

HTTP 410 Gone · Verification link no longer valid

Request a new verification email, then open the latest link.

See Authentication, Errors.

W

waf_blocked

HTTP 403 Forbidden · Request blocked

See Edge rules, Errors.

wait_for_warm

HTTP 503 Service Unavailable · Scale-out cooldown in effect

See Scaling policy.

wait_timed_out

HTTP 408 Request Timeout · Wait timed out

wake_in_progress

The response's title and detail describe the failure.

wake_queue_full

The response's title and detail describe the failure.

webhook_outbox_full

HTTP 429 Too Many Requests · Webhook outbox full

See Event-driven workloads.

webhook_workflow_conflict

HTTP 409 Conflict · Webhook workflow conflict

webhook_workflow_unavailable

HTTP 503 Service Unavailable · Webhook workflow unavailable

wildcard_domains_not_allowed

HTTP 402 Payment Required · Wildcard domains unavailable on this plan

See Domains.

work_policy_in_use

HTTP 409 Conflict · Work policy in use

work_policy_reserved

HTTP 409 Conflict · Reserved work policy

workflow_callback_binding_conflict

HTTP 409 Conflict · Workflow callback binding conflict

workflow_callback_closed

HTTP 409 Conflict · Workflow callback closed

workflow_callback_expired

HTTP 410 Gone · Workflow callback expired

workflow_callback_payload_conflict

HTTP 409 Conflict · Workflow callback payload conflict

workflow_dag_cycle

The response's title and detail describe the failure.

workflow_definition_not_found

HTTP 404 Not Found · Workflow definition not found

workflow_deployment_unavailable

HTTP 501 Not Implemented · Workflow deployment unavailable

workflow_event_not_found

HTTP 404 Not Found

workflow_event_replay_preview_read_timeout

HTTP 503 Service Unavailable · Workflow replay preview read timed out

workflow_function_not_invocable

HTTP 404 Not Found

See Functions and runtimes.

workflow_not_running

HTTP 409 Conflict · Workflow run not running

workflow_performance_cohort_changed

HTTP 409 Conflict · Workflow performance changed

workflow_resume_conflict

HTTP 409 Conflict · Workflow resume conflict

workflow_resume_limit

HTTP 409 Conflict · Workflow resume limit reached

workflow_resume_unsafe

HTTP 409 Conflict · Workflow cannot be resumed

workflow_run_not_found

HTTP 404 Not Found · Workflow run not found

workflow_sdk_missing

The response's title and detail describe the failure.

workflow_step_not_found

HTTP 404 Not Found · Workflow step not found

workflow_step_retry_not_allowed

HTTP 409 Conflict · Workflow step cannot be retried

workflow_tenant_identity_unavailable

HTTP 409 Conflict · Tenant identity required

workflow_wait_interrupted

HTTP 499 · Workflow wait canceled

See CLI guide.

workflow_wait_timeout

HTTP 408 Request Timeout · Workflow wait timed out

See CLI guide.

workload_not_production

HTTP 403 Forbidden · Production workload required

workload_selector_ambiguous

HTTP 400 Bad Request

Spotted a problem on this page? Tell us