> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kubiya.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Workers

> List registered Temporal workers for the organization.

This queries Temporal to get all task queues for the organization
and returns information about registered workers on each queue.

Task queue naming convention: {organization_id}.{runner_name}



## OpenAPI

````yaml https://control-plane.kubiya.ai/api/openapi.json get /api/v1/workers
openapi: 3.1.0
info:
  title: Agent Control Plane API
  description: Multi-tenant agent orchestration with Temporal workflows
  version: 1.0.0
servers: []
security:
  - BearerAuth: []
tags:
  - name: health
    description: 🏥 **Health & Status** - Check API health and availability
  - name: authentication
    description: 🔐 **Authentication** - Token validation and auth management
  - name: agents
    description: 🤖 **Agents** - Create and manage AI agents with custom capabilities
  - name: skills
    description: 🛠️ **Tool Sets** - Manage agent skills and tool configurations
  - name: integrations
    description: 🔌 **Integrations** - Connect to external services (Kubiya managed)
  - name: custom-integrations
    description: >-
      ⚙️ **Custom Integrations** - User-defined integration instances with env
      vars, secrets, and files
  - name: integration-templates
    description: >-
      📦 **Integration Templates** - Pre-configured templates for common
      services (PostgreSQL, Redis, MongoDB, etc.)
  - name: secrets
    description: 🔑 **Secrets** - Secure credential storage and retrieval
  - name: teams
    description: 👥 **Teams** - Team management and collaboration
  - name: workflows
    description: 📊 **Workflows** - Multi-step automation and orchestration
  - name: executions
    description: ▶️ **Executions** - Track and monitor workflow runs
  - name: jobs
    description: ⏰ **Jobs** - Scheduled and webhook-triggered tasks
  - name: policies
    description: 🛡️ **Policies** - Access control and security policies
  - name: analytics
    description: 📈 **Analytics** - Usage metrics and performance monitoring
  - name: projects
    description: 📁 **Projects** - Project organization and management
  - name: environments
    description: 🌍 **Environments** - Environment configuration (dev, staging, prod)
  - name: models
    description: 🧠 **Models** - LLM model configuration and management
  - name: runtimes
    description: ⚡ **Runtimes** - Agent execution runtime environments
  - name: workers
    description: 👷 **Workers** - Worker registration and heartbeat monitoring
  - name: storage
    description: 💾 **Storage** - File storage and cloud integration
  - name: context-graph
    description: 🕸️ **Context Graph** - Knowledge graph and context management
  - name: temporal-workflows
    description: >-
      ⚙️ **Temporal Workflows** - Background workflows for context graph
      ingestion, connector operations, and scheduled jobs
  - name: templates
    description: 📝 **Templates** - Reusable configuration templates
paths:
  /api/v1/workers:
    get:
      summary: List Workers
      description: |-
        List registered Temporal workers for the organization.

        This queries Temporal to get all task queues for the organization
        and returns information about registered workers on each queue.

        Task queue naming convention: {organization_id}.{runner_name}
      operationId: list_workers_api_v1_workers_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/TaskQueueInfo'
                type: array
                title: Response List Workers Api V1 Workers Get
components:
  schemas:
    TaskQueueInfo:
      properties:
        task_queue:
          type: string
          title: Task Queue
        organization_id:
          type: string
          title: Organization Id
        runner_name:
          type: string
          title: Runner Name
        workers:
          items:
            $ref: '#/components/schemas/WorkerInfo'
          type: array
          title: Workers
        worker_count:
          type: integer
          title: Worker Count
        approximate_backlog_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Approximate Backlog Count
      type: object
      required:
        - task_queue
        - organization_id
        - runner_name
        - workers
        - worker_count
        - approximate_backlog_count
      title: TaskQueueInfo
      description: Task queue with worker information
    WorkerInfo:
      properties:
        identity:
          type: string
          title: Identity
        last_access_time:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Access Time
        rate_per_second:
          anyOf:
            - type: number
            - type: 'null'
          title: Rate Per Second
      type: object
      required:
        - identity
        - last_access_time
        - rate_per_second
      title: WorkerInfo
      description: Worker information
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Enter your Kubiya API token (format: Bearer <token>)'

````