PRprefecthq
Work Queues

Read Work Queue By Name

Changed on

Get a work queue by id.

get/api/work_queues/name/{name}

Request

  • The document declares no server URL.
  • Auth
    none declared

Path parameters

namestring required

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