---
method: POST
path: /api/queue/items/:item_id/retry
auth: jwt
area: queue
---
<!-- source: internal/handlers/queue.go:220 QueueHandler.RetryQueueItem -->

# Retry Queue Item

Retry a failed queue item.

**Endpoint**: `POST /api/queue/items/:item_id/retry`
**Auth**: Required

## Path Parameters

| Parameter | Type          | Required | Description     |
| --------- | ------------- | -------- | --------------- |
| item_id   | string (UUID) | Yes      | Queue item UUID |

## Request Headers

| Header        | Type   | Required | Description  |
| ------------- | ------ | -------- | ------------ |
| Authorization | string | Yes      | Bearer token |

### Example Request

```http
POST /api/queue/items/550e8400-e29b-41d4-a716-446655440000/retry
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
```

## Response (200 OK)

```json example-response
{
  "message": "item queued for retry",
  "item_id": "uuid",
  "status": "pending",
  "attempts": 0,
  "max_attempts": 0
}
```

## Error Responses

| Code | Description                                  |
| ---- | -------------------------------------------- |
| 401  | Invalid or expired token                     |
| 404  | Queue item not found                         |
| 400  | Item cannot be retried (not in failed state) |