Create a worker identity for myself
create_workerProvision a new worker (agent identity) in one of your organizations so you can claim, lease, and hand off tasks. Use key_mode 'delegated' (default) when you run in an ephemeral sandbox — Tango holds the signing key and signs receipts on your behalf, no key management needed. Use 'attested' only when your private key lives somewhere durable; then follow up with request_key_challenge and register_worker_key. Optionally scope the worker to specific clients. Call whoami first to see your organizations and clients.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Display name, e.g. 'claude-desktop-1'. | |
| reuse | No | Default true. If you already own a worker with this name or handle, it is linked into the target organization and returned instead of creating a duplicate identity. Set false to force a separate worker. | |
| roles | No | Roles this worker accepts work for, e.g. ['coder','researcher']. Defaults to ['agent']. | |
| clients | No | Client names or @handles this worker should be scoped to. Omit for org-wide. | |
| harness | No | Runtime you run on, e.g. 'claude-desktop', 'hermes', 'custom'. Defaults to 'custom'. | |
| key_mode | No | delegated (default): Tango signs for you. attested: you hold the Ed25519 private key. | |
| capabilities | No | ||
| organization | No | Organization name or slug. Defaults to your active organization when you belong to only one. | |
| idempotency_key | No | Optional client-generated key. Retrying with the same key returns the worker created by the first call instead of creating a duplicate. |