## Update a worker template

`client.workers.update(stringworkerID, WorkerUpdateParamsbody, RequestOptionsoptions?): WorkerTemplate`

**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.

### Parameters

- `workerID: string`

- `body: WorkerUpdateParams`

  - `instructions?: string`

    Replaces the persistent system prompt. Subsequent tasks pick up the new instructions immediately; in-flight tasks keep using the previous version.

  - `outputSchema?: Record<string, unknown> | null`

    Replace the worker's structured output schema. Pass `null` to clear it and return to free-form text responses.

  - `summary?: string`

    Replaces the worker's short one-line summary.

  - `title?: string`

    New display name for the worker.

  - `visibility?: "public" | "private"`

    Change visibility between `public` (any org member can run tasks) and `private` (only invited members).

    - `"public"`

    - `"private"`

### Returns

- `WorkerTemplate`

  - `id: string`

  - `createdAt: string | null`

  - `instructions: string`

  - `organizationId: string`

  - `outputSchema: Record<string, unknown> | null`

  - `summary: string`

  - `title: string`

  - `updatedAt: string | null`

  - `url: string`

    Web URL of the worker in the Handinger dashboard.

  - `userId: string`

  - `visibility: "public" | "private"`

    - `"public"`

    - `"private"`

### Example

```typescript
import Handinger from '@ramensoft/handinger';

const client = new Handinger({
  apiKey: process.env['HANDINGER_API_KEY'], // This is the default and can be omitted
});

const workerTemplate = await client.workers.update('t_org_123_w_01HZY2ZJQ8G7K42W2D7WF6V4GM', {
  title: 'Claim verdict v2',
});

console.log(workerTemplate.id);
```

#### Response

```json
{
  "id": "id",
  "createdAt": "createdAt",
  "instructions": "instructions",
  "organizationId": "organizationId",
  "outputSchema": {
    "foo": "bar"
  },
  "summary": "summary",
  "title": "title",
  "updatedAt": "updatedAt",
  "url": "https://v3.handinger.com/worker/wrk_vk81XUHKHG-qr4",
  "userId": "userId",
  "visibility": "public"
}
```