---
title: "Register a new worker"
method: POST
path: "/workers"
tags: ["Workers"]
---

# Register a new worker

`POST /workers`

Pre-registers a worker by name, creates a pending DB row, and returns a single-use bootstrap token.
The operator passes this token when starting the worker daemon (`worker join --token <token>`).

## Request body

- InternalPkgCatalogApiserverHandlersCreateWorkerReq
  - `worker_name` string, required

## Response `201`

Worker registered; token valid for 24 hours

- InternalPkgCatalogApiserverHandlersCreateWorkerResp
  - `token` string
  - `worker_name` string

## Other responses

- `400` — Invalid payload
- `500` — Internal error

---

[API](https://skmtc.dev/ibm/apis/ai-services-catalog-api.md) · [All operations](https://skmtc.dev/ibm/apis/ai-services-catalog-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ibm/ai-services-catalog-api/revisions/b6ffcee23f74/schema)