> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kombify.io/llms.txt
> Use this file to discover all available pages before exploring further.

# techstack api workers

> Generierte Referenz für die Befehle unter techstack api workers

<Note>Generiert aus dem Techstack-Release v0.39.0 (Quelle `49677b729cb9`). Für eine installierte Version ist `techstack api <command> --help` maßgeblich.</Note>

## techstack api workers approve

Ausstehenden Worker freigeben.

```bash theme={null}
techstack api workers approve <id> [flags]
```

| | |
| - | - |
| HTTP | `POST /api/v1/workers/{id}/approve` |
| Ändert Zustand | Ja |
| MCP-Tool | `approve_worker` |

| Argument | Typ | Beschreibung |
| - | - | - |
| `<id>` | string | **Erforderlich.** Ressourcen-ID. |

## techstack api workers identity upgrade approve

Den von einem Legacy-Server vorgeschlagenen Schlüssel freigeben.

Bindet den durch `key_thumbprint` bezeichneten ausstehenden Schlüssel und bindet damit den Worker an den Schlüssel (Anfragen nur mit Bearer-Credential werden danach abgelehnt). Erfordert den Owner und eine frische Multi-Faktor-Anmeldung (höchstens 300 Sekunden alt). Freigebendes Subjekt und Zeitpunkt werden mit der Identität aufgezeichnet und protokolliert. 409 `identity_upgrade_not_pending`, wenn kein noch gültiger ausstehender Schlüssel diesen Fingerabdruck hat.

```bash theme={null}
techstack api workers identity upgrade approve <id> [flags]
```

<Warning>Erfordert Bestätigung: Diese Operation entscheidet, welcher Schlüssel den Server steuern darf; gib nur einen Schlüssel frei, dessen Fingerabdruck Guard auf dem Server protokolliert. Übergib `--yes` oder beantworte die Rückfrage; ein nicht interaktiver Lauf ohne `--yes` stoppt vor jeder Anfrage mit Exit-Code 9.</Warning>

| | |
| - | - |
| HTTP | `POST /api/v1/workers/{id}/identity/upgrade/approve` |
| Ändert Zustand | Ja |
| MCP-Tool | `approve_worker_identity_upgrade` |

| Argument | Typ | Beschreibung |
| - | - | - |
| `<id>` | string | **Erforderlich.** Ressourcen-ID. |
| `--key-thumbprint` | string | **Erforderlich.** |
| `--body` | json | JSON-Request-Body (`application/json`) als Literal, `@path` oder `-` für stdin. |

## techstack api workers identity upgrade reject

Den von einem Legacy-Server vorgeschlagenen Schlüssel verwerfen.

Zurücksetzen durch den Owner, wenn der ausstehende Schlüssel nicht der eigene Schlüssel des Servers ist: Der Vorschlag wird verworfen und muss erneut gestellt werden. Das Rotieren der Server-Zugangsdaten beendet den Zugriff ihres Inhabers auf den Bindungs-Endpoint.

```bash theme={null}
techstack api workers identity upgrade reject <id> [flags]
```

| | |
| - | - |
| HTTP | `POST /api/v1/workers/{id}/identity/upgrade/reject` |
| Ändert Zustand | Ja |
| MCP-Tool | Keine |

| Argument | Typ | Beschreibung |
| - | - | - |
| `<id>` | string | **Erforderlich.** Ressourcen-ID. |

## techstack api workers identity upgrade-status

Anzeigen, ob der Identitätsschlüssel eines Servers noch freigegeben werden muss.

Für den Owner des Workers. `identity_binding=legacy_bearer` mit `code=guard_identity_upgrade_required` bedeutet, dass der Server sich ausschließlich mit seinem Bearer-Credential authentifiziert und nur beobachtet wird. `pending` enthält den Fingerabdruck des vorgeschlagenen Schlüssels; der Owner vergleicht ihn mit dem von Guard auf dem Server protokollierten Fingerabdruck. Ein Worker eines anderen Tenants oder Owners liefert 404.

```bash theme={null}
techstack api workers identity upgrade-status <id> [flags]
```

| | |
| - | - |
| HTTP | `GET /api/v1/workers/{id}/identity/upgrade` |
| Ändert Zustand | Nein |
| MCP-Tool | `get_worker_identity_upgrade` |

| Argument | Typ | Beschreibung |
| - | - | - |
| `<id>` | string | **Erforderlich.** Ressourcen-ID. |

## techstack api workers identity upgrades

Die Server des Owners auflisten, die auf die Freigabe ihres Identitätsschlüssels warten.

Für den Owner. Jeder Eintrag ist ein eigener Server, der einen Schlüssel vorgeschlagen hat und nur beobachtet wird, bis genau dieser Schlüssel mit `approveWorkerIdentityUpgrade` freigegeben wurde (frische Multi-Faktor-Anmeldung erforderlich). Die Einträge enthalten Hostnamen und Schlüssel-Fingerabdruck zum Vergleich mit dem von Guard auf dem Server protokollierten Fingerabdruck. Das Auflisten erteilt keine Rechte.

```bash theme={null}
techstack api workers identity upgrades [flags]
```

| | |
| - | - |
| HTTP | `GET /api/v1/workers/identity-upgrades` |
| Ändert Zustand | Nein |
| MCP-Tool | `list_worker_identity_upgrades` |

## techstack api workers list

Registrierte Worker auflisten (nach Owner gefiltert).

```bash theme={null}
techstack api workers list [flags]
```

| | |
| - | - |
| HTTP | `GET /api/v1/workers` |
| Ändert Zustand | Nein |
| MCP-Tool | `list_workers` |

| Argument | Typ | Beschreibung |
| - | - | - |
| `--page` | integer | Seitennummer (Standard 1). |
| `--per-page` | integer | Einträge pro Seite (Standard 20, max. 100). |

## techstack api workers outcomes list

Die ungeklärten Operationsergebnisse eines kombify Guard auflisten.

Listet die Operationen eines eigenen Workers auf, deren Ergebnis unbekannt ist: kombify Guard hat aufgezeichnet, dass die Wirkung möglicherweise eingetreten ist, möglicherweise aber auch nicht, und keine Beobachtung dies geklärt hat. Jede solche Operation sperrt weitere Änderungen am Server. `state` ist `reconciling`, solange Guard die Klärung versucht, und `needs_operator`, sobald das Ergebnis über die konfigurierte Zeit hinaus ungeklärt blieb (`TECHSTACK_GUARD_OUTCOME_NEEDS_OPERATOR_AFTER`, standardmäßig 30 Minuten). Die Zeit verändert ausschließlich die Darstellung des Ergebnisses; sie hebt die Sperre niemals auf. Ein Worker eines anderen Tenants oder Owners liefert 404.

```bash theme={null}
techstack api workers outcomes list <id> [flags]
```

| | |
| - | - |
| HTTP | `GET /api/v1/workers/{id}/outcomes` |
| Ändert Zustand | Nein |
| MCP-Tool | `list_guard_unresolved_outcomes` |

| Argument | Typ | Beschreibung |
| - | - | - |
| `<id>` | string | **Erforderlich.** Ressourcen-ID. |

## techstack api workers outcomes resolve

Ein ungeklärtes Operationsergebnis des kombify Guard freigeben.

Speichert für eine Operation mit unbekanntem Ergebnis eine neue Operator-Auflösungsrevision, die die bisherigen Einträge nur ergänzt, und hebt die Sperre des Workers auf. `disposition` ist `verified_applied` (die Wirkung liegt vor), `verified_not_applied` (es ist nichts geschehen) oder `accept_unknown` (Freigabe ohne verifiziertes Ergebnis); `note` hält fest, was verifiziert wurde. Akteur ist das authentifizierte Subjekt; es wird mit der Revision aufgezeichnet. Ein Guard darf diese Festlegungen nicht speichern. Eine frische Multi-Faktor-Anmeldung (höchstens 300 Sekunden alt) ist erforderlich. `expected_revision` muss der von der Liste zurückgegebenen Revision entsprechen, andernfalls 409 `outcome_revision_stale`. Der Body wird strikt dekodiert: exakte Schlüssel, keine unbekannten Felder.

```bash theme={null}
techstack api workers outcomes resolve <id> <command-id> [flags]
```

<Warning>Erfordert Bestätigung: Diese Operation hebt die Sperre einer Operation auf, deren Ergebnis nie geklärt wurde; dadurch können widersprüchliche Änderungen am Server ausgeführt werden. Übergib `--yes` oder beantworte die Rückfrage; ein nicht interaktiver Lauf ohne `--yes` stoppt vor jeder Anfrage mit Exit-Code 9.</Warning>

| | |
| - | - |
| HTTP | `POST /api/v1/workers/{id}/outcomes/{command_id}/resolve` |
| Ändert Zustand | Ja |
| MCP-Tool | Keine |

| Argument | Typ | Beschreibung |
| - | - | - |
| `<id>` | string | **Erforderlich.** Ressourcen-ID. |
| `<command-id>` | string | **Erforderlich.** |
| `--disposition` | string | **Erforderlich.** Mögliche Werte: `verified_applied`, `verified_not_applied`, `accept_unknown`. |
| `--expected-revision` | integer | **Erforderlich.** |
| `--note` | string | **Erforderlich.** |
| `--body` | json | JSON-Request-Body (`application/json`) als Literal, `@path` oder `-` für stdin. |

## techstack api workers prechecks list

Pre-Check-Ergebnisse für einen Worker abrufen.

```bash theme={null}
techstack api workers prechecks list <id> [flags]
```

| | |
| - | - |
| HTTP | `GET /api/v1/workers/{id}/prechecks` |
| Ändert Zustand | Nein |
| MCP-Tool | Keine |

| Argument | Typ | Beschreibung |
| - | - | - |
| `<id>` | string | **Erforderlich.** Ressourcen-ID. |
| `--page` | integer | Seitennummer (Standard 1). |
| `--per-page` | integer | Einträge pro Seite (Standard 20, max. 100). |

## techstack api workers prechecks run

Pre-Checks auf einem Worker ausführen.

```bash theme={null}
techstack api workers prechecks run <id> [flags]
```

| | |
| - | - |
| HTTP | `POST /api/v1/workers/{id}/prechecks` |
| Ändert Zustand | Ja |
| MCP-Tool | Keine |

| Argument | Typ | Beschreibung |
| - | - | - |
| `<id>` | string | **Erforderlich.** Ressourcen-ID. |
| `--checks` | object\[] | **Erforderlich.** |
| `--stack-id` | string | — |
| `--timeout-seconds` | integer | Standard `30`. |
| `--worker-id` | string | — |
| `--body` | json | JSON-Request-Body (`application/json`) als Literal, `@path` oder `-` für stdin. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.