---
title: "Update a worker template"
method: PATCH
path: "/api/workers/{workerId}"
tags: ["Workers"]
---

# Update a worker template

`PATCH /api/workers/{workerId}`

Update a worker's instructions, title, summary, visibility, or output schema. Only the fields you send are changed; omitted fields keep their current values. Only the worker creator can update a worker.

## Path parameters

- `workerId` string, required

## Request body

- UpdateWorkerRequest
  - `title` string — New display name for the worker.
  - `instructions` string — Replaces the persistent system prompt. Subsequent tasks pick up the new instructions immediately; in-flight tasks keep using the previous version.
  - `summary` string — Replaces the worker's short one-line summary.
  - `visibility` 'public' | 'private' — Change visibility between `public` (any org member can run tasks) and `private` (only invited members).
  - `outputSchema` object, nullable — Replace the worker's structured output schema. Pass `null` to clear it and return to free-form text responses.

## Response `200`

Updated worker template.

- WorkerTemplate
  - `id` string, required
  - `title` string, required
  - `instructions` string, required
  - `summary` string, required
  - `visibility` 'public' | 'private', required
  - `outputSchema` object, nullable, required
  - `url` string, required — Web URL of the worker in the Handinger dashboard.
  - `organizationId` string, required
  - `userId` string, required
  - `createdAt` string, nullable, required
  - `updatedAt` string, nullable, required

## Other responses

- `401` — Unauthorized.
- `403` — Forbidden.
- `404` — Not found.
- `429` — Rate limit exceeded.
- `500` — Internal server error.

---

[API](https://skmtc.net/ramensoft/apis/handinger-api.md) · [All operations](https://skmtc.net/ramensoft/apis/handinger-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ramensoft/handinger-api/versions/95b6b61a63ef/schema)