Sign in
Work Queues

Read Work Queue By Name

Get a work queue by id.

get/api/work_queues/name/{name}

Path parameters

namestring required

The work queue name

The work queue name

Headers

x-prefect-api-versionstring

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 1 of the 50 revisions of this API.1

  • 00512a1ecb661See the full diff
    • ○

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

      response-optional-property-added