Error Code Catalog

This document lists all error codes used by Phala Cloud API. Error codes follow the format ERR-{MODULE}-{CODE} where:

MODULE: Two-digit module identifier (01, 02, 03, …)
CODE: Three-digit sequential error number within the module

Modules

Module 01 - CVM API / Preflight
Module 02 - Inventory
Module 03 - CVM Operations
Module 04 - Workspace
Module 05 - Credentials
Module 06 - Auth
Module 09 - Billing
Module 10 - GPU Rental
Module 11 - Centralized KMS
Module 12 - KMS
Module 14 - Confidential AI
Module 16 - Trust Center
Module 17 - Log Access

Module 01: CVM API / Preflight

Error Code	Message
`ERR-01-001`	The requested node is not available
`ERR-01-002`	The request contains invalid parameters
`ERR-01-003`	The Docker Compose file contains errors
`ERR-01-004`	(dynamic: A CVM with name ’…)
`ERR-01-005`	Compose hash registration required on-chain
`ERR-01-006`	The provided compose hash is invalid or has expired
`ERR-01-007`	Transaction verification failed
`ERR-01-008`	The compose hash is not allowed by the on-chain contract
`ERR-01-009`	VM creation failed on the target node
`ERR-01-010`	The deployment violates the terms of use
`ERR-01-011`	node_id and teepod_id are not supported for node selection

Module 02: Inventory

Error Code	Message
`ERR-02-001`	The requested instance type does not exist
`ERR-02-002`	No available resources match your requirements
`ERR-02-003`	The selected node does not have enough CPU capacity
`ERR-02-004`	The selected node does not have enough memory
`ERR-02-005`	The selected node has reached its maximum capacity
`ERR-02-006`	The selected node does not have enough GPU resources
`ERR-02-007`	The selected node does not have enough GPU resources
`ERR-02-008`	The request contains invalid parameters
`ERR-02-009`	The configuration parameters are not compatible with each other
`ERR-02-010`	The requested operating system image is not available
`ERR-02-011`	The requested security configuration is not available on this node
`ERR-02-012`	The requested node is not available
`ERR-02-013`	The requested operating system image is not available
`ERR-02-014`	The requested node is not available
`ERR-02-015`	Your account has reached its resource quota
`ERR-02-016`	GPUs are available but currently occupied at device level
`ERR-02-017`	No enabled gateway is available for the selected node
`ERR-02-018`	This node has multiple device IDs; specify which one to use
`ERR-02-019`	This node has no device ID configured
`ERR-02-020`	Failed to allocate an app ID from the centralized KMS
`ERR-02-021`	The requested KMS was not found
`ERR-02-022`	The requested KMS node was not found
`ERR-02-023`	The KMS node did not respond
`ERR-02-024`	Invalid GPU product requirement
`ERR-02-025`	GPU instance type has no configured GPU product requirement
`ERR-02-026`	(dynamic: This CVM’s active GPU allocation does not match th…)
`ERR-02-027`	(dynamic: A GPU CVM cannot be resized into an instance type …)
`ERR-02-028`	(dynamic: Instance type ’…)
`ERR-02-029`	(dynamic: This instance type requires …)
`ERR-02-030`	The requested KMS is disabled
`ERR-02-031`	The requested KMS contract is disabled
`ERR-02-032`	(dynamic message)
`ERR-02-033`	Port mappings cannot be set at creation for an instance type that uses bridge networking.

Module 03: CVM Operations

Error Code	Message
`ERR-03-001`	No CVM found with the specified name in this workspace
`ERR-03-002`	Multiple CVMs have the same name in this workspace
`ERR-03-003`	No CVM found in this workspace
`ERR-03-004`	The requested CVM was not found
`ERR-03-005`	The requested CVM was not found
`ERR-03-006`	The source CVM’s OS image is not available on the target node
`ERR-03-007`	This app_id already has an active CVM with a different configuration. Provision again to get a new app_id, or use the existing CVM.
`ERR-03-008`	The source CVM instance was not found in this workspace or access is denied
`ERR-03-009`	This app has multiple live CVM instances. Please specify compose_hash to choose which revision to replicate.
`ERR-03-010`	Multiple CVMs match this identifier in the workspace
`ERR-03-014`	The target OS image is not compatible with the source CVM
`ERR-03-015`	Another operation is already in progress for this CVM
`ERR-03-016`	Port mappings were saved, but the node firewall still has a rule that should have been created or removed.
`ERR-03-017`	The revision expects different environment variable names. Provide a re-encrypted encrypted_env value or set allow_env_mismatch to true to continue.
`ERR-03-018`	This machine cannot start with the selected OS image, node version, and key provider pin. Choose a compatible combination and try again.
`ERR-03-019`	The current compose revision for this CVM could not be found
`ERR-03-020`	The current compose revision failed integrity validation
`ERR-03-022`	We could not set up the GPU for this CVM. The problem is on our side, so changing your compose file will not fix it.
`ERR-03-023`	We could not stop this CVM. The host did not finish the stop. The problem is on our side.
`ERR-03-024`	This CVM could not get its keys from KMS while it was booting, so it did not start. The problem is on our side, so changing your compose file will not fix it.
`ERR-03-025`	This CVM booted, but it could not register with the Phala Cloud gateway, so the start failed. The problem is on our side, so changing your compose file will not fix it.
`ERR-03-026`	The container registry rejected the login when this CVM tried to pull an image from your compose file.
`ERR-03-027`	KMS did not let this CVM boot. Its compose hash is not on your app’s allow list.
`ERR-03-028`	This CVM did not boot because one of its environment variables was rejected. A name or a value is empty, too long, or not valid.
`ERR-03-029`	(dynamic: The …)
`ERR-03-030`	Guest agent access for this app is restricted to Phala Cloud. Relaxing the restriction requires Phala Cloud support.
`ERR-03-031`	Manifest version 3 is not supported by this legacy endpoint. Use app-compose.json instead.
`ERR-03-032`	This CVM’s configuration on our side is incomplete, so we cannot reach it right now. Please contact support.
`ERR-03-033`	The CVM has no resumable in-progress operation
`ERR-03-034`	The operation’s task is still running
`ERR-03-035`	The operation changed while it was being resumed
`ERR-03-036`	This CVM is protected from deletion
`ERR-03-037`	This CVM is protected from shutdown
`ERR-03-038`	This CVM cannot start while its host is being decommissioned.
`ERR-03-039`	This CVM is being deleted.
`ERR-03-040`	(dynamic: cannot be changed on an existing CVM…)
`ERR-03-041`	tproxy_enabled cannot be set when creating a CVM. Use gateway_enabled instead.
`ERR-03-042`	requirements.gpu_policy is not enabled for this account or workspace.
`ERR-03-043`	requirements.launch_token_hash does not match this app’s launch token.
`ERR-03-044`	This app already has a different launch token.
`ERR-03-045`	(dynamic: is not enabled for this account or workspace…)
`ERR-03-046`	(dynamic: Runner …)
`ERR-03-047`	(dynamic: The …)
`ERR-03-048`	(dynamic: Turning on …)
`ERR-03-049`	CVM annotations are not enabled for this account or workspace.
`ERR-03-050`	(dynamic: The node runs dstack VMM …)
`ERR-03-051`	(dynamic: The node could not read or update the CVM annotati…)
`ERR-03-052`	This CVM has no staged changes.
`ERR-03-053`	The CVM changed after these changes were staged.
`ERR-03-054`	The staged changes were changed by another request. Load them and try again.
`ERR-03-055`	CVMs of this app still require the launch token, so it cannot be cleared.
`ERR-03-056`	This app_id is reserved and cannot be deployed
`ERR-03-057`	This CVM is not reachable via its node right now. Retry in a moment, or contact support if it persists.
`ERR-03-058`	Send either init_script or init_scripts, not both.

Module 04: Workspace

Error Code	Message
`ERR-04-001`	Top up your Balance before launching a CVM.
`ERR-04-002`	Your account has reached the maximum number of instances
`ERR-04-003`	The requested resources exceed your account limits
`ERR-04-004`	Workspace billing is suspended. Please settle your outstanding balance before proceeding.
`ERR-04-005`	This workspace has been closed. Contact support if you wish to recover it.
`ERR-04-006`	You have an unpaid workspace. Settle the balance before creating a new workspace.
`ERR-04-007`	A webhook with this URL already exists in this workspace.
`ERR-04-008`	This workspace already has 10 webhooks. Delete one before adding another.
`ERR-04-009`	Add a payment method or create a CVM before adding a webhook.
`ERR-04-010`	We could not check your payment methods. Try again later.

Module 05: Credentials

Error Code	Message
`ERR-05-001`	(dynamic: You have reached the maximum of …)
`ERR-05-002`	(dynamic: Rate limit exceeded: maximum …)

Module 06: Auth

Error Code	Message
`ERR-06-001`	Your email address did not pass our security verification.
`ERR-06-002`	Account is disabled.
`ERR-06-003`	Account deleted and in cooling-off period. Contact support for assistance.
`ERR-06-004`	Account is disabled
`ERR-06-005`	Account deleted and in cooling-off period. Contact support for assistance.
`ERR-06-006`	You do not have permission to perform this action.
`ERR-06-007`	Access denied
`ERR-06-008`	Your workspace role does not grant this permission
`ERR-06-009`	This API key is not allowed to use this permission
`ERR-06-010`	API keys cannot access this user route
`ERR-06-012`	API keys cannot access slug-resolved workspace routes

Module 09: Billing

Error Code	Message
`ERR-09-001`	Post-paid billing and direct billing for Private AI cannot be enabled for the same workspace
`ERR-09-009`	Payments are paused for this workspace because its billing profile needs a manual fix on our side
`ERR-09-010`	Workspace not found
`ERR-09-011`	Too many payment attempts.
`ERR-09-012`	Payments are temporarily unavailable. Try again shortly.
`ERR-09-013`	This payment was declined. Try another card.
`ERR-09-014`	Monthly invoice contains Private AI lines; One Balance cannot allocate this invoice as CVM-only
`ERR-09-015`	One Balance was enabled while the monthly invoice was being generated
`ERR-09-017`	App not found

Module 10: GPU Rental

Error Code	Message
`ERR-10-020`	The GPU rental order is not active
`ERR-10-021`	The GPU rental’s machines changed during the request.

Module 11: Centralized KMS

Error Code	Message
`ERR-11-001`	This workspace has no signing wallet yet, so the next app ID cannot be predicted.
`ERR-11-002`	Could not predict the next app ID. Please try again.
`ERR-11-003`	Wallet provisioning is unavailable. Please try again later.

Module 12: KMS

Error Code	Message
`ERR-12-001`	The app ID is not a valid KMS app identifier
`ERR-12-002`	The KMS did not return the environment encryption public key
`ERR-12-003`	The KMS replica did not pass its health check

Module 14: Confidential AI

Error Code	Message
`ERR-14-001`	Private AI API key not found
`ERR-14-002`	Could not create the Private AI API key
`ERR-14-004`	usage mapping missing
`ERR-14-005`	Invalid usage time range
`ERR-14-006`	Private AI is already being connected for this workspace. Try again in a moment.

Module 16: Trust Center

Error Code	Message
`ERR-16-001`	The app or instance was not found.
`ERR-16-002`	The CVM is not running.
`ERR-16-003`	The guest agent timed out.
`ERR-16-004`	The guest agent is unreachable.

Module 17: Log Access

Error Code	Message
`ERR-17-001`	Invalid log request
`ERR-17-002`	Missing or invalid log access signature
`ERR-17-003`	Log access signature expired
`ERR-17-004`	CVM not found or access denied
`ERR-17-005`	CVM is not running
`ERR-17-006`	Container logs are disabled
`ERR-17-007`	Container not found
`ERR-17-008`	Node VMM unreachable or returned a bad response
`ERR-17-009`	Guest agent or gateway unreachable
`ERR-17-010`	Log upstream timed out
`ERR-17-011`	Too many concurrent log streams
`ERR-17-012`	Node or gateway routing data is unavailable
`ERR-17-013`	VM no longer exists on the node

Retired Codes

Retired codes are never reused.

Error Code	Retired
`ERR-03-021`	2026-10-22

​Error Code Catalog

​Modules

​Module 01: CVM API / Preflight

​Module 02: Inventory

​Module 03: CVM Operations

​Module 04: Workspace

​Module 05: Credentials

​Module 06: Auth

​Module 09: Billing

​Module 10: GPU Rental

​Module 11: Centralized KMS

​Module 12: KMS

​Module 14: Confidential AI

​Module 16: Trust Center

​Module 17: Log Access

​Retired Codes

Error Code Catalog

Modules

Module 01: CVM API / Preflight

Module 02: Inventory

Module 03: CVM Operations

Module 04: Workspace

Module 05: Credentials

Module 06: Auth

Module 09: Billing

Module 10: GPU Rental

Module 11: Centralized KMS

Module 12: KMS

Module 14: Confidential AI

Module 16: Trust Center

Module 17: Log Access

Retired Codes