Create, change or delete a queue
queue_settingsCreate a queue or change its settings: lease, max_attempts before dead letter, max_messages (fields left out stay); returns the queue as queue_status shows it. Optional: queue_put makes a queue on first use, with a 60 s lease, 5 attempts and room for 10,000 messages. delete: true deletes the queue with all its messages, 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": {
"queue": "jobs",
"instance_id": "que_exampleexampleexample2",
"max_attempts": 5,
"visibility_timeout_seconds": 120
},
"name": "queue_settings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| queue | Yes | Queue name: 1 to 64 characters from a-z 0-9 . _ -. | |
| delete | No | true: delete the queue and its messages. | |
| instance_id | Yes | Utility instance id from buy or list_utilities. | |
| max_attempts | No | Claims before a message goes to the dead letters. | |
| max_messages | No | Size limit of the queue. | |
| passport_token | No | Your amp_ token, only if you have no app sign-in and cannot send a header. | |
| visibility_timeout_seconds | No | Default lease in seconds. |