---
title: "Revoke Worker"
method: POST
path: "/v1/workers/{worker_id}/revoke"
tags: ["private-workers"]
---

# Revoke Worker

`POST /v1/workers/{worker_id}/revoke`

## Request

- Base URL: `https://api.cybret.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cybret.ai/v1/workers/{worker_id}/revoke`
- Auth: HTTP bearer

## Path parameters

- `worker_id` string, required

## Response `200`

Successful Response

- PrivateWorker: Tenant-bound private worker record safe for API responses.
  - `worker_id` string, required
  - `tenant_id` string, required
  - `display_name` string, required
  - `status` 'active' | 'revoked' | 'outdated' | 'disabled', required
  - `agent_version` string, required
  - `min_supported_version` string, required
  - `credential_version` integer, required
  - `posture` WorkerPosture, required: Non-secret runtime posture reported by the worker.
    - `agent_version` string, required
    - `platform` string
    - `outbound_only` boolean
    - `capabilities` string[]
    - `region` string
    - `data_residency` string
  - `last_seen_at` string, date-time, nullable
  - `revoked_at` string, date-time, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cybret/apis/api-scanner-control-plane.md) · [All operations](https://skmtc.dev/cybret/apis/api-scanner-control-plane/llms.txt) · [OpenAPI document](https://skmtc.dev/cybret/apis/api-scanner-control-plane/revisions/4c9b522246af?raw)