Sign in
Work Pools

Create Work Queue

Creates a new work pool queue. If a work pool queue with the same name already exists, an error will be raised.

post/api/work_pools/{work_pool_name}/queues

Path parameters

work_pool_namestring required

The work pool name

The work pool name

Headers

x-prefect-api-versionstring

Request body

namestring required

The name of the work queue.

descriptionstring

An optional description for the work queue.

is_pausedboolean

Whether or not the work queue is paused.

concurrency_limitinteger

The work queue's concurrency limit.

priorityinteger

The queue's priority. Lower values are higher priority (1 is the highest).

Response

Successful Response

idstring uuid
createdstring date-time
updatedstring date-time
namestring required

The name of the work queue.

descriptionstring

An optional description for the work queue.

is_pausedboolean

Whether or not the work queue is paused.

concurrency_limitinteger

An optional concurrency limit for the work queue.

priorityinteger

The queue's priority. Lower values are higher priority (1 is the highest).

work_pool_idstring uuid

The work pool with which the queue is associated.

last_polledstring date-time

The last time an agent polled this queue for work.

work_pool_namestring

The name of the work pool the work pool resides within.

status'READY' | 'NOT_READY' | 'PAUSED'

Enumeration of work queue statuses.

Changes

Changed in 2 of the 50 revisions of this API.111

  • 93ae2b3f2efd11See the full diff
    • ▲

      the request property name became required

      request-property-became-required

    • ●

      the priority request property's min was set to 1.00

      request-property-min-set

  • 00512a1ecb661See the full diff
    • ○

      added the optional property status to the response with the 201 status

      response-optional-property-added