List, redrive or purge dead letters
queue_deadA queue's dead letters (messages claimed max_attempts times without an ack): list them (oldest first, each with body, attempts and last_error; page with after), redrive them back to the queue as new, attempts 0 (ids from list, or all: true), or purge them for good.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"limit": 20,
"queue": "jobs",
"action": "list",
"instance_id": "que_exampleexampleexample2"
},
"name": "queue_dead"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| all | No | redrive: every dead letter. | |
| ids | No | redrive: message ids (qms_...) from list. | |
| after | No | list: next_after of the previous page. | |
| limit | No | list: how many (default 20). | |
| queue | Yes | Queue name: 1 to 64 characters from a-z 0-9 . _ -. | |
| action | Yes | list, redrive (back to the queue) or purge (delete). | |
| instance_id | Yes | Utility instance id from buy or list_utilities. | |
| passport_token | No | Your amp_ token, only if you have no app sign-in and cannot send a header. |