Skip to content
Merged
Show file tree
Hide file tree
Changes from 3 commits
Commits
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
77 changes: 77 additions & 0 deletions src/content/docs/queues/reference/error-codes.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
---
pcx_content_type: reference
title: Error codes
sidebar:
order: 4
---

This page documents error codes returned by Queues when using the [Workers API](/r2/api/workers/).

## 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 messag 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:

```
{
"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 | HTTP Status | Details | Recommended actions |
| ---------- | ------------------------ | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | --- |
| 10104 | QueueNotFound | Queue does not exist | Check for existence of `queue_id` in [List Queues endpoint](/api/resources/queues/) |
| 10105 | FeatureFlagNotSet | Feature flag not set | Ensure that feature flag is set past `February 17, 2026` compatibility date |

Check warning on line 52 in src/content/docs/queues/reference/error-codes.mdx

View workflow job for this annotation

GitHub Actions / Semgrep

semgrep.style-guide-potential-date-year

Potential year found. Documentation should strive to represent universal truth, not something time-bound. (add [skip style guide checks] to commit message to skip)

Check warning on line 52 in src/content/docs/queues/reference/error-codes.mdx

View workflow job for this annotation

GitHub Actions / Semgrep

semgrep.style-guide-potential-date-month

Potential month found. Documentation should strive to represent universal truth, not something time-bound. (add [skip style guide checks] to commit message to skip)
| 10106 | Unauthorized | Unauthorized request | ?? |
| 10107 | QueueIDMalformed | Malformed queue ID in the request URL | Ensure `queue_id` matches response for that queue from [List Queues endpoint](/api/resources/queues/) | |
| 10201 | ClientDisconnected | Client disconnected during request processing | ?? |
| 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) | ?? |
| 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 | API Gateway request JSON body does not match expected schema | Ensure that JSON body matches the expected schema |
| 10208 | JSONRequestBodyMalformed | API Gateway request body is not valid JSON | REST API request body is not valid. Look at error message for additional details. |

### 429 type errors

| Error Code | HTTP Status | Details | Recommended actions |
| ---------- | ------------------------- | ---------------------------- | -------------------------------------------------------------------------------------------------- |
| 10250 | QueueOverloaded | Queue is overloaded | ?? |
| 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 | HTTP Status | Details |
| ---------- | -------------------- | ------------- |
| 15000 | UnknownInternalError | Unknown error |
2 changes: 1 addition & 1 deletion src/content/docs/queues/reference/wrangler-commands.mdx
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