functions-errors-group
HIDE/functions-errors-introduction/
Functions Errors
All error responses use the standard envelope format:
{
"meta": { "timestamp": "...", "correlationId": "..." },
"errors": [{ "code": "FAAS-1004", "message": "Package with ID [...] was not found!" }]
}
The code field is a stable machine-readable identifier. The message field is a human-readable description that may include contextual details.
| Code | HTTP Status | Description |
|---|---|---|
FAAS-400 | 400 | Validation or parameter error. |
FAAS-403 | 403 | Forbidden — insufficient permissions. |
FAAS-405 | 405 | HTTP method not allowed. |
FAAS-406 | 406 | Requested media type not acceptable. |
FAAS-409 | 409 | Unique constraint violation. |
FAAS-415 | 415 | Unsupported media type. |
FAAS-500 | 500 | Internal server error. |
FAAS-1000 | 400 | Invalid correlation ID format. |
FAAS-1001 | 401 | Authentication credentials not provided. |
FAAS-1002 | 401 | Invalid authentication credential. |
FAAS-1003 | 400 | Malformed JSON payload. |
FAAS-1004 | 400 | Entity not found. |
FAAS-1005 | 422 | Account package limit reached. |
FAAS-1006 | 422 | Functions per package revision limit reached. |
FAAS-1007 | 400 | Scheduled event has invalid date/time. |
FAAS-1008 | 423 | Deployment cannot be started — transitional state. |
FAAS-1009 | 423 | Deployment cannot be stopped — transitional state. |
FAAS-1010 | 409 | Scheduled event cannot be deleted. |
FAAS-1011 | 409 | Deprecated. Scheduled event cannot be updated. |
FAAS-1012 | 500 | Deployment failed to start. |
FAAS-1013 | 500 | Deployment failed to stop. |
FAAS-1014 | 409 | Deployment cannot be deleted. |
FAAS-1015 | 409 | Package revision already assigned to keyset. |
FAAS-1016 | 409 | Package cannot be deleted — has active deployments. |
FAAS-1017 | 409 | Package revision cannot be deleted — has active deployments. |
FAAS-1018 | 400 | Malformed page token. |
FAAS-1019 | 400 | Page size must be greater than zero. |
FAAS-1020 | 400 | Subkey parameter is required. |
FAAS-1021 | 400 | KV key not found. |
FAAS-1022 | 400 | Subkey not found. |
FAAS-1023 | 400 | Parameter validation failed. |
FAAS-1024 | 500 | Secrets storage operation failed. |
FAAS-1025 | 401 | Deprecated. Failed to validate session token due to network issue. |
FAAS-1026 | 409 | Cannot delete the last test input from a function. |
FAAS-1027 | 403 | User does not have required permissions. |
FAAS-1028 | 422 | Package revision cannot be created — validation failed. |
FAAS-1029 | 400 | Pagination not supported for this query. |
FAAS-1030 | 409 | Keyset is disabled. |
FAAS-1031 | 409 | Running deployment limit reached for account. |
FAAS-1032 | 422 | Invalid stop parameters. |
FAAS-1034 | 500 | Failed to enable functions on keyset. |
FAAS-1035 | 422 | Rolling update requires same keyset. |
FAAS-1036 | 422 | Code transpilation failed. |
FAAS-1037 | 500 | Code transpilation service unavailable. |
FAAS-1038 | 422 | Package revision validation failed. |
FAAS-1039 | 409 | Package revision limit reached. |
FAAS-1040 | 409 | Deployment limit per revision reached. |
FAAS-1041 | 409 | Test input limit per function reached. |
FAAS-1042 | 409 | Deployment has channel or path conflicts. |
FAAS-1043 | 503 | Deprecated. Account not found for the specified Keyset. |
FAAS-1044 | 400 | Deprecated. Ambiguous authentication — multiple auth methods provided. |
FAAS-1045 | 500 | Service unavailable. |
FAAS-1046 | 422 | Rolling update requires same package. |
FAAS-1047 | 401 | Authentication method not supported on this endpoint. |
FAAS-1049 | 422 | The PubNub-Version header is required for all public API endpoints. |
FAAS-1050 | 422 | Function code length exceeds limit. |
FAAS-1051 | 400 | PubNub-Version header has an invalid API version format. |
FAAS-1052 | 409 | Database constraint or data integrity violation. |