---
source_url: https://www.pubnub.com/docs/admin-api/functions-errors-introduction
title: Functions Errors Introduction
---

# Functions Errors Introduction

> For AI agents: documentation index at https://www.pubnub.com/llms-full.txt

## Functions Errors

All error responses use the standard envelope format:

```json
{
  "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. |
| `FAAS-1053` | 423 | Account is temporarily locked - write operations are rejected until the account returns to ACTIVE. |
| `FAAS-1055` | 422 | Function code contains a character that cannot be stored. |
| `FAAS-1056` | 422 | A submitted value is malformed or out of range. |

## [🗃️ Packages](https://www.pubnub.com/docs/admin-api/packages-introduction.md)

6 items

## [🗃️ Revisions](https://www.pubnub.com/docs/admin-api/revisions-introduction.md)

10 items

## [🗃️ Deployments](https://www.pubnub.com/docs/admin-api/deployments-introduction.md)

8 items

## [🗃️ Catalog](https://www.pubnub.com/docs/admin-api/catalog-introduction.md)

7 items

## [🗃️ KV Store](https://www.pubnub.com/docs/admin-api/kv-store-introduction.md)

12 items

## [🗃️ Secrets Storage](https://www.pubnub.com/docs/admin-api/secrets-storage-introduction.md)

3 items

## [🗃️ Scheduled Events](https://www.pubnub.com/docs/admin-api/scheduled-events-introduction.md)

5 items

## [🗃️ Limits](https://www.pubnub.com/docs/admin-api/limits-introduction.md)

1 item

## [📄️ Functions Errors](https://www.pubnub.com/docs/admin-api/functions-errors-introduction.md)

Functions Errors Introduction
