Skip to content

Adding queues error codes #28402

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mia303 merged 10 commits into from
Feb 20, 2026
+77 −1
Merged

Adding queues error codes #28402

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
abd642e
adding-error-codes
mia303 Feb 17, 2026
0f0ebfa
adding-recommendation-actions
mia303 Feb 17, 2026
6029834
updating-actions
mia303 Feb 18, 2026
b5563bb
updated-links-and-actions
mia303 Feb 18, 2026
378e6a8
adding-rec-actions
mia303 Feb 18, 2026
a174926
Update error-codes.mdx
mia303 Feb 18, 2026
3b24334
remove-flag-error
mia303 Feb 18, 2026
30d8ad3
Update error-codes.mdx
mia303 Feb 20, 2026
9893c2b
Update src/content/docs/queues/reference/error-codes.mdx
mia303 Feb 20, 2026
3d54be2
Apply suggestions from code review
mia303 Feb 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
76 changes: 76 additions & 0 deletions src/content/docs/queues/reference/error-codes.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,76 @@
---
pcx_content_type: reference
title: Error codes
sidebar:
order: 4
---

This page documents error codes returned by Queues when using the [Queues Cloudflare API](/api/resources/queues/methods/create/).

## How errors are returned

For the [JavaScript APIs](/queues/configuration/javascript-apis/), Queues operations throw exceptions that you can catch. The error code is included at the end of the `message` property:

```js
try {
await env.MY_QUEUE.send("message", { delaySeconds: 999999 });
return new Response("Sent message to the queue");
} catch (error) {
console.error(error);
return new Response("Failed to send message to the queue", { status: 500 });
}
```

For the [Cloudflare API via HTTP](/api/resources/queues/subresources/messages/), the response will include an `errors` object which has both a `message` and `code` field:

```json
{
"errors": [
{
"code": 7003,
"message": "No route for the URI",
"documentation_url": "documentation_url",
"source": {
"pointer": "pointer"
}
}
],
"messages": [
"string"
],
"success": true
}
```

## Error code reference

### Client side errors

| Error Code | Error | Details | Recommended actions |
| ---------- | ------------------------ | -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 10104 | QueueNotFound | Queue does not exist | Check for existence of `queue_id` in [List Queues endpoint](/api/resources/queues/) |
| 10106 | Unauthorized | Unauthorized request | Ensure that current user has permission to push to that queue. |
| 10107 | QueueIDMalformed | The queue ID in the request URL is not a valid queue identifier | Ensure that `queue_id` contains only alphanumeric characters. |
| 10201 | ClientDisconnected | Client disconnected during request processing | Consider increasing timeout and retry message send. |
| 10202 | BatchDelayInvalid | Invalid batch delay | Ensure that `batch_delay` is within 1 and 86400 seconds |
| 10203 | MessageMetadataInvalid | Invalid message metadata (includes invalid content type and invalid delay) | Ensure `contentType` is one of `text`, `bytes`, `json`, or `v8`. Ensure the message delay does not exceed the [maximum of 24 hours](/queues/platform/limits/) |
| 10204 | MessageSizeOutOfBounds | Message size out of bounds | Ensure that message size is within 0 and 128 KB |
| 10205 | BatchSizeOutOfBounds | Batch size out of bounds | Ensure that batch size is within 0 and 256 KB |
| 10206 | BatchCountOutOfBounds | Batch count out of bounds | Ensure that batch count is within 0 and 100 messages |
| 10207 | JSONRequestBodyInvalid | Request JSON body does not match expected schema | Ensure that JSON body matches the expected schema |
| 10208 | JSONRequestBodyMalformed | Request body is not valid JSON | [REST API](/api/resources/queues/methods/create/) request body is not valid. Look at error message for additional details. |

### 429 type errors

| Error Code | Error | Details | Recommended actions |
| ---------- | ------------------------- | ---------------------------- | -------------------------------------------------------------------------------------------------- |
| 10250 | QueueOverloaded | Queue is overloaded | Temporarily back off sending messages to the queue. |
| 10251 | QueueStorageLimitExceeded | Queue storage limit exceeded | [Purge queue](/queues/configuration/pause-purge/#purge-queue) or wait for queue to process backlog |
| 10252 | QueueDisabled | Queue disabled | [Unpause queue](/queues/configuration/pause-purge/#pause-delivery) |
| 10253 | FreeTierLimitExceeded | Free tier limit exceeded | Upgrade to Workers Paid |

### 500 type errors

| Error Code | Error | Details |
| ---------- | -------------------- | ------------- |
| 15000 | UnknownInternalError | Unknown error |
2 changes: 1 addition & 1 deletion src/content/docs/queues/reference/wrangler-commands.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
pcx_content_type: navigation
title: Wrangler commands
sidebar:
order: 30
order: 3

---

Expand Down
Loading