---
title: "List all workers"
method: GET
path: "/v1/workers"
tags: ["Admin"]
---

# List all workers

`GET /v1/workers`

List all workers with their definitions

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

OK

- SchemasOffsetPageSchemasWorkerResponse
  - `items` SchemasWorkerResponse[]
    - `binding` SchemasBindingResponse
      - `id` string
      - `type` 'static' | 'tenant' | 'project' | 'account'
    - `enabled` boolean
    - `http` SchemasHTTPWorkerConfigResponse
      - `retry` integer
      - `secret` SchemasSecretResponse
        - `binding` 'static' | 'tenant' | 'project' | 'account'
        - `editable` boolean
        - `exists` boolean
        - `value` string
      - `timeout` integer
      - `uri` string
    - `id` string
    - `managed` boolean
    - `mcp` SchemasMCPWorkerConfigResponse
      - `external_id` string
      - `headers` SchemasMCPWorkerHeadersResponse
      - `oauth2` SchemasMCPOAuth2ConfigResponse
        - `authorization_url` string
        - `client_id` string
        - `client_secret` SchemasSecretResponse
          - `binding` 'static' | 'tenant' | 'project' | 'account'
          - `editable` boolean
          - `exists` boolean
          - `value` string
        - `external_id` string
        - `redirect_uri` string
        - `supported_scopes` string[]
      - `redirect_uri` string
      - `retry` integer
      - `secrets` object
      - `timeout` integer
      - `uri` string
    - `requirements` SchemasWorkerRequirementsResponse
      - `authorization` SchemasWorkerAuthorizationRequirementResponse
        - `met` boolean
        - `oauth2` SchemasOAuth2AuthorizationRequirementResponse
          - `met` boolean
      - `met` boolean
    - `type` 'http' | 'mcp' | 'unknown'
  - `limit` integer
  - `offset` integer
  - `page_count` integer
  - `total_count` integer

## Other responses

- `500` — Internal Server Error

## Changes

- **2026-04-10** `1ef78b1a5567` — 2 info
  - added the optional property `items/items/mcp/external_id` to the response with the `200` status
  - added the optional property `items/items/mcp/redirect_uri` to the response with the `200` status
- **2026-02-26** `6ff494eafa2c` — 1 info
  - added the optional property `items/items/mcp/oauth2/external_id` to the response with the `200` status
- **2026-02-26** `e2406b137c08` — 1 info
  - added the optional property `items/items/mcp/oauth2/supported_scopes` to the response with the `200` status
- **2026-02-18** `2a6c58164e9f` — 3 warning
  - removed the optional property `items/items/http/secret/hint` from the response with the `200` status
  - removed the optional property `items/items/mcp/oauth2/client_secret/hint` from the response with the `200` status
  - removed the optional property `items/items/mcp/secrets/additionalProperties/hint` from the response with the `200` status
- **2025-10-30** `f59a2fe653b8` — 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `Bearer` was added to the API

[Full history](https://skmtc.dev/arcadeai/apis/arcade-api/changes/v1/workers/get.md)

---

[API](https://skmtc.dev/arcadeai/apis/arcade-api.md) · [All operations](https://skmtc.dev/arcadeai/apis/arcade-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/arcadeai/arcade-api/revisions/a509111298b2/schema)