Sign in

v27

latestOpenAPI 3.1.0LicenseRef-Proprietaryraw.githubusercontent.com2026-07-21173076.1 KB
Workers

Update a worker template

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.

patch/api/workers/{workerId}

Path parameters

workerIdstring required
Example:t_org_123_w_01HZY2ZJQ8G7K42W2D7WF6V4GM

Worker id returned by the create worker endpoint.

Request body

titlestring

New display name for the worker.

instructionsstring

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

summarystring

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

outputSchemaobject nullable

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

Example request

{
  "title": "Brand voice analyzer",
  "instructions": "You are a brand voice analyzer. Read the input text and report whether it matches Acme's playful, plain-spoken house style. Quote specific phrases.",
  "summary": "Audits copy against the Acme brand voice guide.",
  "visibility": "private",
  "outputSchema": {
    "type": "object",
    "required": [
      "verdict",
      "summary"
    ],
    "properties": {
      "verdict": {
        "type": "string",
        "enum": [
          "supported",
          "debunked",
          "mixed",
          "unknown"
        ]
      },
      "summary": {
        "type": "string"
      },
      "citations": {
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    }
  }
}

Response

Updated worker template.

idstring required
titlestring required
instructionsstring required
summarystring required
visibility'public' | 'private' required
outputSchemaobject nullable required
urlstring required

Web URL of the worker in the Handinger dashboard.

organizationIdstring required
userIdstring required
createdAtstring nullable required
updatedAtstring nullable required

Example response

{
  "url": "https://v3.handinger.com/worker/wrk_vk81XUHKHG-qr4"
}