Error code reference
Every error code with its HTTP status, title, hint and the page that explains it.
On this page
- A
- account_abuse_hold
- account_deletion_confirm_required
- account_deletion_managed_postgres_databases
- account_deletion_pending
- account_deploy_blocked
- account_egress_allowlist_extra_out_of_range
- account_exists
- account_not_restorable
- admin_required
- admission_refused
- alert_preset_disabled
- alert_preset_invalid
- alert_preset_test_rate_limited
- alert_rule_invalid
- api_key_expired
- api_key_limit_exceeded
- api_key_revoked
- api_rate_limited
- app_admission_unavailable
- app_arch_mismatch
- app_concurrency_reached
- app_deleted
- app_has_buckets
- app_has_dependents
- app_has_postgres_bindings
- app_health_unavailable
- app_healthz_unauthorized
- app_layer_too_large
- app_log_drain_invalid
- app_logs_unavailable
- app_loopback_bound
- app_maintenance_mode
- app_manifest_invalid
- app_not_listening
- app_not_purgeable
- app_not_restorable
- app_protocol_invalid
- app_rename_failed
- app_runtime_oom
- app_startup_crash
- app_startup_timeout
- app_static_egress_ip_invalid
- app_unavailable
- app_visibility_invalid
- app_webhook_invalid
- approval_denied
- approval_expired
- approval_required
- auth_rate_limited
- B
- bad_gateway
- bad_request
- before_checkpoint_failed
- billing_already_cancelled
- billing_cancel_failed
- billing_contact_member
- billing_email_change_failed
- billing_email_in_use
- billing_past_due
- billing_plan_change_failed
- billing_provider_unavailable
- billing_subscription_ending
- billing_unavailable
- binding_verification_budget_full
- binding_verification_run_changed
- binding_verification_run_limit
- bindings_check_changed
- bindings_check_failed
- bindings_gate_unavailable
- bindings_release_policy_changed
- bindings_release_required
- build_failed
- build_infrastructure_failed
- build_not_found
- build_oom
- build_provenance_not_found
- build_sbom_unavailable
- build_timeout
- build_undetected
- C
- canary_step_conflict
- capability_not_released
- capacity_unavailable
- challenge_required
- cli_auth_code_pending
- cli_auth_code_unavailable
- cold_wake_rate_limited
- companion_preset_unavailable
- concurrency_queue_full
- concurrency_queue_timeout
- concurrency_throttled
- config_guard_not_found
- config_revision_not_found
- conflict
- control_plane_busy
- control_plane_unavailable
- cors_origin_not_allowed
- cors_preset_too_large
- cron_fire_now_busy
- cron_invalid
- csrf_mismatch
- csrf_missing
- custom_metric_limit
- D
- data_upstreams_disabled
- database_cutover_fenced
- database_switch_in_progress
- database_switch_not_cancellable
- database_switch_unavailable
- database_switches_active
- debug_regressions_unavailable
- debug_replay_unsupported
- dep_install_failed
- deploy_failed
- deploy_rate_limited
- deploy_settings_conflict
- deploy_signature_invalid
- deployment_attempt_accepted
- deployment_attempt_pending
- deployment_cancel_live_forbidden
- deployment_cancel_not_cancellable
- deployment_check_target_changed
- deployment_cron_conflict
- deployment_hide_in_flight
- deployment_not_live
- deployment_promotion_attempt_accepted
- deployment_promotion_attempt_conflict
- deployment_queue_timeout
- deployment_reorder_not_pending
- deployment_reorder_priority_invalid
- deployment_scope_collision
- deployment_smoke_failed
- deployment_stalled
- deployment_verification_unavailable
- dev_debug_not_developer_environment
- dev_debug_session_limit
- dev_session_tearing_down
- dev_source_base_missing
- dev_source_diverged
- dev_watch_unsupported
- developer_seed_failed
- developer_sync_history_unavailable
- domain_cert_not_issued
- domain_not_verified
- domain_verification_failed
- dry_run_requires_post
- E
- edge_feature_unavailable
- edge_overloaded
- edge_rule_conflict
- edge_rule_list_exists
- edge_rule_list_in_use
- edge_rule_list_not_found
- edge_rule_maintenance
- edge_rule_not_found
- edge_rules_version_mismatch
- egress_allowlist_too_long
- egress_ports_too_many
- email_missing
- email_not_verified
- email_verification_required
- empty_body
- env_batch_request_conflict
- env_batch_revision_conflict
- env_scope_invalid
- env_scope_reserved
- env_value_too_large
- env_var_invalid_key
- env_var_missing
- env_var_not_found
- environment_cleanup_pending
- environment_field_ownership_conflict
- environment_full_clone_unavailable
- environment_promotion_attempt_accepted
- environment_promotion_attempt_conflict
- environment_queue_collection_unavailable
- environment_rollback_attempt_accepted
- environment_rollback_attempt_conflict
- environment_work_busy
- environment_work_ownership_conflict
- environment_work_policy_collection_unavailable
- event_publish_batch_too_large
- event_publish_not_attempted
- event_storage_capacity_exhausted
- event_stream_unavailable
- exclude_only_overlap
- exclude_unknown_slug
- execution_mode_conflict
- export_rate_limited
- F
- financial_budget_activation_unavailable
- financial_budget_held
- financial_compute_budget_too_low
- financial_compute_not_ready
- financial_compute_unavailable
- forged
- function_init_failed
- function_input_invalid
- function_send_rate_limited
- G
- gateway_overloaded
- geo_denied
- github_account_conflict
- github_app_not_installed
- github_install_ambiguous
- github_install_not_found
- github_install_not_owned
- github_installation_choice_required
- github_installation_not_accessible
- github_installation_owner_required
- github_installation_required
- github_integration_unavailable
- github_not_bound
- github_org_admin_required
- github_permission_pending
- github_repo_not_accessible
- github_unreachable
- gitlab_company_project_unavailable
- gitlab_connection_required
- google_id_token_invalid
- google_id_token_missing
- google_identity_mismatch
- google_unreachable
- H
- handler_missing
- header_mutation_forbidden
- http_admission_unavailable
- http_error
- I
- idempotency_conflict
- idempotency_key_reused
- image_abuse_detected
- image_egress_denied
- image_manifest_invalid
- image_not_found
- image_required
- image_secret_detected
- inbound_webhook_backlog_full
- inbound_webhook_bad_signature
- inbound_webhook_invalid
- inbound_webhook_rate_limited
- inbound_webhook_routing_conflict
- inbound_webhook_too_large
- init_sidecar_failed
- insights_query_timeout
- instance_busy
- insufficient_scope
- internal
- internal_error
- invalid_autoscale_target_cpu_pct
- invalid_autoscale_target_rps
- invalid_body
- invalid_canary_preset
- invalid_cooldown
- invalid_cpu_millicores
- invalid_cpu_ram_pair
- invalid_credentials
- invalid_cursor
- invalid_egress_allowlist
- invalid_egress_port
- invalid_max_instances
- invalid_min_instances
- invalid_mirror_percent
- invalid_mirror_window
- invalid_nonce
- invalid_openapi_shape
- invalid_pkce
- invalid_public_auth_ip_allowlist
- invalid_ram_mb
- invalid_recover_action
- invalid_ref
- invalid_registry_host
- invalid_request
- invalid_resource_profile
- invalid_scheduled_at
- invalid_source
- invalid_state
- invalid_traffic_percent
- invalid_warm_pool_size
- invalid_warm_snapshot_min_ms
- invalid_warm_snapshot_min_requests
- invocation_environment_work_isolation_unavailable
- invocation_not_found
- invocation_not_replayable
- invocation_replay_unavailable
- invocation_version_conflict
- invocation_version_unavailable
- invocation_wait_interrupted
- invocation_wait_timeout
- ip_denied
- J
- job_command_invalid
- job_deadline_exceeded
- job_has_live_instances
- job_image_missing
- job_quota_exceeded
- job_registry_credential_not_found
- job_run_cancelled
- job_task_max_retries_reached
- job_task_not_found
- job_task_not_retriable
- jobs_not_allowed
- json_error
- jwt_audience_mismatch
- jwt_missing_issuer
- jwt_missing_token
- jwt_signature_invalid
- L
- log_archive_degraded
- log_archive_invalid_query
- log_archive_missing
- log_archive_retention_exceeded
- log_archive_unconfigured
- log_reads_busy
- log_streams_limit
- long_poll_timeout
- M
- managed_postgres_ambiguous
- managed_postgres_binding_changed
- managed_postgres_binding_limit
- managed_postgres_binding_not_ready
- managed_postgres_binding_target_missing
- managed_postgres_forbidden
- managed_postgres_not_found
- managed_postgres_not_in_plan
- managed_postgres_not_ready
- managed_postgres_plan_unknown
- managed_postgres_quota_exceeded
- managed_postgres_unavailable
- max_min_instances_exceeded
- method_not_allowed
- mfa_disable_cooldown
- mfa_invalid_code
- mfa_last_recovery_code
- mfa_required
- migration_recovery_blocked
- mirror_cross_app_mismatch
- mirror_deployment_not_live
- mirror_rule_not_found
- mirror_rule_quota_exceeded
- mirror_slot_at_capacity
- mirror_source_target_same
- misdirected_request
- missing_code
- missing_doc
- N
- no_live_deployment
- no_rollback_target
- not_found
- notification_channel_in_use
- notification_channel_invalid
- notification_channel_limit_reached
- notification_channel_test_rate_limited
- O
- oauth_exchange_failed
- oauth_provider_unavailable
- obs_runtime_busy
- openapi_docs_not_allowed
- openapi_import_invalid
- openapi_import_quota_reached
- openapi_import_too_large
- openapi_import_too_many_endpoints
- openapi_policy_confirmation_required
- openapi_policy_stale
- org_already_member
- org_api_key_requires_org
- org_free_limit_exceeded
- org_invitation_cap_exceeded
- org_invitation_expired
- org_invitation_invalid
- org_last_owner
- org_member_cap_exceeded
- org_mfa_required
- org_not_found
- org_personal_immutable
- org_role_forbidden
- org_slug_invalid
- org_slug_taken
- outbound_probe_unavailable
- overage_cap_above_max
- overage_cap_required
- P
- password_too_weak
- payment_authentication_required
- payment_required
- penalty_box
- plan_alert_presets_not_allowed
- plan_alert_rule_quota
- plan_alert_rules_not_allowed
- plan_app_errors_not_allowed
- plan_app_protocol_grpc_not_allowed
- plan_app_usage_summary_not_allowed
- plan_async_backlog
- plan_autoscale_not_allowed
- plan_cors_preset_quota_reached
- plan_cors_presets_not_allowed
- plan_cron_quota
- plan_crons_not_allowed
- plan_custom_metrics_not_allowed
- plan_delayed_tasks_cap
- plan_edge_rule_kind_not_allowed
- plan_edge_rule_kind_quota_reached
- plan_egress_allowlist_not_allowed
- plan_egress_overage_not_allowed
- plan_egress_ports_not_allowed
- plan_empty
- plan_eviction_priority_reserved_not_allowed
- plan_eviction_priority_reserved_quota
- plan_feature_gated
- plan_feature_unavailable
- plan_gate_blocked
- plan_health_path_wakes_not_allowed
- plan_inbound_webhook_quota
- plan_inbound_webhooks_not_allowed
- plan_internal_ingress_not_allowed
- plan_job_registry_credential_quota
- plan_job_registry_credentials_not_allowed
- plan_limit_apps
- plan_limit_build_minutes
- plan_limit_concurrency
- plan_limit_deployment_aliases
- plan_limit_developer_apps
- plan_limit_developer_lease
- plan_limit_edge_rule_list_items
- plan_limit_edge_rule_lists
- plan_limit_edge_rules
- plan_limit_env_vars
- plan_limit_project_secrets
- plan_limit_ram
- plan_limit_secrets
- plan_limit_trusted_signers
- plan_liveness_probe_not_allowed
- plan_log_archive_not_allowed
- plan_log_drain_quota
- plan_log_drains_not_allowed
- plan_max_instances_not_allowed
- plan_min_instances_not_allowed
- plan_mirror_not_allowed
- plan_openapi_doc_quota_reached
- plan_openapi_doc_too_large
- plan_per_app_metrics_not_allowed
- plan_private_network_not_allowed
- plan_public_auth_basic_not_allowed
- plan_public_auth_bearer_not_allowed
- plan_public_auth_ip_allowlist_not_allowed
- plan_queue_backlog_bytes
- plan_queue_depth
- plan_registry_credential_quota
- plan_registry_credentials_not_allowed
- plan_reorder_disabled
- plan_require_authn_not_allowed
- plan_rollback_on_5xx_not_allowed
- plan_route_metrics_not_allowed
- plan_source_bytes
- plan_static_egress_ip_not_allowed
- plan_static_egress_ip_quota
- plan_streaming_not_allowed
- plan_token_stale
- plan_traffic_split_not_allowed
- plan_trigger_quota
- plan_triggers_not_allowed
- plan_warm_pool_not_allowed
- plan_warm_snapshot_not_allowed
- plan_webhook_quota
- plan_webhooks_not_allowed
- plan_websocket_not_allowed
- plan_workflows_not_allowed
- plan_workflows_quota
- platform_release_paused
- postgres_custom_roles_limit
- postgres_custom_roles_unavailable
- postgres_custom_roles_unsupported
- pr_preview_resource_unsupported
- preflight_busy
- preflight_check_failed
- preflight_invalid_source
- preflight_rate_limited
- preflight_repo_not_found
- preflight_source_too_large
- preflight_upstream_unavailable
- preview_environment_not_found
- preview_expired
- preview_full
- preview_not_found
- preview_not_offered
- preview_org_unsupported
- preview_plan_not_eligible
- preview_production_dependency_denied
- private_invocation_disabled
- private_network_fabric_unavailable
- private_network_invalid
- private_network_not_enabled
- private_network_transport_unavailable
- private_network_unavailable
- private_publication_disabled
- prod_branch_mismatch
- project_apply_stale
- project_configuration_failed
- project_environment_approval_invalid
- project_environment_approval_required
- project_promotion_queue_full
- project_release_baseline_expired
- project_release_control_conflict
- project_release_rollback_required
- project_release_secrets_pinned
- project_required
- project_retry_changed
- project_selection_empty
- project_services_call_each_other
- project_submission_exists
- project_submission_mismatch
- promotion_rolled_back
- provision_capacity
- public_auth_config_invalid
- public_auth_ip_allowlist_too_long
- Q
- queue_binding_environment_unavailable
- queue_binding_keyed_work
- queue_binding_retired
- queue_canary_changed
- queue_environment_work_policy_unavailable
- queue_groups_unavailable
- queue_message_not_processed
- queue_receive_busy
- queue_replay_requires_binding
- quota_exhausted
- R
- rate_limit_unavailable
- rate_limited
- realtime_unavailable
- recent_sign_in_required
- registry_credential_not_found
- regression_changed
- release_approval_canary_required
- release_approval_decided
- release_approval_policy_not_found
- release_approval_rejected
- release_approval_required
- release_approval_self
- release_approval_session_required
- release_command_failed
- release_freeze_limit
- release_freeze_not_found
- release_freeze_override_not_allowed
- release_frozen
- release_gate_limit
- release_gate_not_found
- release_graph_changed
- release_infrastructure_failed
- release_not_parked
- release_outcome_uncertain
- release_phase_unavailable
- release_scheduled
- release_staging_changed
- request_body_read_failed
- request_budget_exceeded
- request_too_large
- request_upload_timeout
- request_validation_failed
- reset_token_expired
- reset_token_invalid
- response_too_large
- rollback_attempt_accepted
- rollback_attempt_conflict
- rollback_crosses_release
- rollback_deployment_changed
- rollback_operation_required
- rollback_target_already_live
- rollback_target_database_restored
- rollback_target_ineligible
- rollback_target_not_found
- rollback_target_unavailable
- rollout_not_stuck
- rollout_state_invalid
- route_health_blocked
- S
- safe_release_unavailable
- scaling_request_conflict
- scaling_revision_conflict
- scaling_target_incompatible_with_workload_class
- scan_critical
- scheduled_release_not_found
- scope_exclusion_not_found
- secret_entry_unavailable
- secret_invalid_key
- secret_not_found
- secret_reference_conflict
- secret_reference_suppression_limit
- secret_scan_strict
- secret_store_unavailable
- secret_value_too_large
- security_posture_blocked
- security_quarantine_recovery_blocked
- security_scan_blocked
- service_abort_attempt_accepted
- service_abort_attempt_conflict
- service_recovery_capacity_unavailable
- session_expired
- session_invalid
- sidecar_cap_exceeded
- sidecar_invalid_cpu_millicores
- sidecar_invalid_disk_io_profile
- sidecar_invalid_image
- sidecar_invalid_name
- sidecar_invalid_port
- sidecar_invalid_ram_mb
- sidecar_invalid_scratch_mb
- sidecar_invalid_type
- sidecar_not_allowed_on_plan
- sidecar_stateful_denied
- snapshot_backoff
- snapshot_unavailable
- source_invalid
- source_ref_stale
- source_ref_unavailable
- source_too_large
- stage_dependency_restore_failed
- stage_image_build_oom
- stage_image_build_timeout
- stage_readiness_failed
- stage_security_scan_findings
- stage_snapshot_prepare_timeout
- stage_source_download_failed
- stateless_only_violation
- statement_invoice_export_in_progress
- static_egress_ip_not_enabled
- static_egress_ip_not_provisioned
- step_up_required
- streaming_not_available
- synthetic_check_invalid
- synthetic_check_limit_reached
- T
- traffic_change_during_canary
- traffic_deadline_invalid
- traffic_deadline_unavailable
- traffic_percent_sum_invalid
- traffic_policy_too_complex
- traffic_policy_too_large
- traffic_policy_unavailable
- traffic_revocation_unavailable
- traffic_revoked
- traffic_serving_changed
- traffic_split_release_limit
- transport_error
- trigger_batch_window_too_large
- trigger_immutable
- trigger_inconsistent
- trigger_invalid_config
- trigger_invalid_retry_policy
- trigger_kind_not_allowed
- trigger_kind_unavailable
- trigger_tls_skip_verify_not_allowed
- trusted_signer_invalid
- trusted_signer_not_found
- U
- udp_listener_limit
- unauthorized
- unavailable
- undo_plan_changed
- undo_too_many_changes
- unsupported_by_cli
- unsupported_media_type
- upload_checksum_mismatch
- upload_session_already_cancelled
- upload_session_already_committed
- upload_session_expired
- upload_session_not_found
- upload_session_offset_conflict
- upload_session_too_many
- V
- validation_failed
- verification_link_invalid
- W
- waf_blocked
- wait_for_warm
- wait_timed_out
- wake_in_progress
- wake_queue_full
- webhook_outbox_full
- webhook_workflow_conflict
- webhook_workflow_unavailable
- wildcard_domains_not_allowed
- work_policy_in_use
- work_policy_reserved
- workflow_callback_binding_conflict
- workflow_callback_closed
- workflow_callback_expired
- workflow_callback_payload_conflict
- workflow_dag_cycle
- workflow_definition_not_found
- workflow_deployment_unavailable
- workflow_event_not_found
- workflow_event_replay_preview_read_timeout
- workflow_function_not_invocable
- workflow_not_running
- workflow_performance_cohort_changed
- workflow_resume_conflict
- workflow_resume_limit
- workflow_resume_unsafe
- workflow_run_not_found
- workflow_sdk_missing
- workflow_step_not_found
- workflow_step_retry_not_allowed
- workflow_tenant_identity_unavailable
- workflow_wait_interrupted
- workflow_wait_timeout
- workload_not_production
- workload_selector_ambiguous
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
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.
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
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
config_revision_not_found
HTTP 404 Not Found · Config revision not found
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
deployment_stalled
The response's title and detail describe the failure.
See Deploys.
deployment_verification_unavailable
HTTP 503 Service Unavailable
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
env_scope_reserved
HTTP 400 Bad Request · Env scope reserved
env_value_too_large
HTTP 413 Request Entity Too Large · Invalid sidecar env; Env var value too large
env_var_invalid_key
HTTP 400 Bad Request · Invalid env var key
env_var_missing
HTTP 422 Unprocessable Entity · Missing environment variable
env_var_not_found
HTTP 400 Bad Request · Env var not set
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
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
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
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
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
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
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
invocation_not_replayable
HTTP 409 Conflict · Invocation not replayable; Invocation is not in a replayable state
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.
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.
log_archive_unconfigured
HTTP 503 Service Unavailable · Archived logs temporarily unavailable
Retry shortly, or use gregale logs APP for live logs.
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
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
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
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
plan_inbound_webhooks_not_allowed
HTTP 402 Payment Required · Inbound webhooks unavailable on this plan
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
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
plan_queue_depth
HTTP 403 Forbidden · Per-app queue depth exceeded
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
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
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
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
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.
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
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
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
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.
verification_link_invalid
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
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
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