---
title: "Test a worker connection"
method: POST
path: "/v1/workers/test"
tags: ["Admin"]
---

# Test a worker connection

`POST /v1/workers/test`

Test a worker connection before adding it to the system

## Request body

- SchemasWorkerTestRequest
  - `http` SchemasHTTPWorkerTestConfig
    - `uri` string, required
  - `mcp` SchemasMCPWorkerTestConfig
    - `uri` string, required
  - `type` string, required

## Response `200`

OK

- SchemasWorkerTestResponse
  - `message` string
  - `serverInfo` SchemasServerInfoResponse
    - `description` string
    - `name` string
    - `version` string
  - `success` boolean

## Other responses

- `400` — Invalid request body or URI
- `500` — Internal Server Error

## Changes

- **2026-01-16** `581f0f279edc` — 2 info
  - the `http/uri` request property's maxLength was increased from `256` to `2048`
  - the `mcp/uri` request property's maxLength was increased from `256` to `2048`
- **2025-10-30** `f59a2fe653b8` — 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `Bearer` was added to the API

[Change history](https://skmtc.dev/arcadeai/apis/arcade-api/changes/v1/workers/test/post.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)