> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blujay.io/llms.txt
> Use this file to discover all available pages before exploring further.

# QUEUE_FULL

> Phone number queue full

| HTTP status | Retryable |
| - | - |
| `429` | Yes |

## What happened

The phone number already has as many messages waiting as it can hold.

## How to fix it

Wait for `Retry-After` seconds, then retry with the same idempotency key. `queue.remaining` on `GET /v1/phone-numbers` shows current room.

> [!TIP]
>
> This error is safe to retry. Wait for the `Retry-After` header when it is present. If the endpoint takes an `Idempotency-Key`, reuse the same key so a retry never creates a duplicate.

## Example response

An illustrative example. The `message` wording and the contents of `details` vary; branch on `error.code`.

```json theme={null}
{
  "status": "error",
  "error": {
    "code": "QUEUE_FULL",
    "message": "Phone number queue full",
    "type": "queue",
    "http_status": 429,
    "retryable": true,
    "doc_url": "https://docs.blujay.io/errors/queue-full",
    "details": [
      {
        "limit_type": "phone_number_queue",
        "scope": "phone_number",
        "phone_number_id": "phone_abc123",
        "remaining": 0,
        "reset_at": "2026-10-14T17:35:48.000Z"
      }
    ],
    "retry_after": 300
  },
  "trace_id": "trc_8f2a1c0e4b7d",
  "timestamp": "2026-10-14T17:30:48.000Z"
}
```

## Still stuck?

Email [support@blujay.io](mailto:support@blujay.io) with the `trace_id` from the error response. See [Errors](/errors.md) for the response format.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.