Get Worker Queue Config

Get worker queue configuration with version tracking for auto-updates.

This endpoint is called by CLI workers periodically to check for configuration changes. The config_version hash allows workers to detect when they need to reload.

Args: queue_id: Worker queue ID

Returns: Configuration with version hash and recommended package version

GET /api/v1/worker-queues/{queue_id}/config

Get Worker Queue Config

cURL

curl --request GET \
  --url https://control-plane.kubiya.ai/api/v1/worker-queues/{queue_id}/config \
  --header 'Authorization: Bearer <token>'

200

{
  "queue_id": "<string>",
  "name": "<string>",
  "display_name": "<string>",
  "description": "<string>",
  "status": "<string>",
  "max_workers": 123,
  "heartbeat_interval": 123,
  "tags": [
    "<string>"
  ],
  "settings": {},
  "config_version": "<string>",
  "config_updated_at": "<string>",
  "environment_id": "<string>",
  "environment_name": "<string>",
  "recommended_package_version": "<string>"
}

Authorizations

Authorization · string · header · required

Enter your Kubiya API token (format: Bearer )

Path Parameters

queue_id · string · required

Response

200

application/json

Successful Response

Worker queue configuration with version tracking for auto-updates

queue_id · string · required

name · string · required

display_name · string | null · required

description · string | null · required

status · string · required

max_workers · integer | null · required

heartbeat_interval · integer · required

tags · string[] · required

settings · Settings · object · required

config_version · string · required

config_updated_at · string · required

environment_id · string · required

environment_name · string · required

recommended_package_version · string | null