Sign in
Querator V1

Create a queue

Create a new queue with the provided characteristics

post/v1/queue.create

Request body

namestring required

The name of the queue

created_atstring date-time required

The timestamp the queue was created

updated_atstring date-time required

The timestamp the queue was last updated

dead_queuestring required

The name of the dead letter queue for this queue. If this is a dead letter queue then this field will be empty when retrieved via /queue.list

referencestring required

This is a user supplied field which could contain metadata or specify who owns this queue

reserve_timeoutstring required

The default reservation timeout for this queue

dead_timeoutstring required

How long an item can wait in the queue regardless of attempts before it is moved to the dead letter queue

max_attemptsinteger required

The maximum number of times an item can be defered by a consumer before it is placed in the dead letter queue. This includes cases where the 'deadline' was exceeded and the item was retried.

requested_partitionsinteger required

The number of partitions this queue hasrequested. This might be different than the number of currently active partitionsas the system grows or contracts the number of partitions.

Example request

{
  "name": "queue-name",
  "created_at": "2024-01-01 12:00:00.0000",
  "updated_at": "2024-01-01 12:00:00.0000",
  "dead_queue": "queue-name-dead",
  "reference": "jake@statefarm.com",
  "reserve_timeout": "60m",
  "dead_timeout": "24h"
}

Response

codeinteger required
code_textstring required
messagestring required

Changes