---
title: "Revoke an executor and all active credentials"
method: POST
path: "/v1/executors/{id}/revoke"
tags: ["Executors"]
---

# Revoke an executor and all active credentials

`POST /v1/executors/{id}/revoke`

## Request

- Base URL: `https://api.thrd.email`
- URL: `https://api.thrd.email/v1/executors/{id}/revoke`
- Auth: API key in header `x-admin-token`

Requires a server-authenticated tenant owner/operator with executors:manage. Agent API keys are rejected. Revocation is tenant-bound, audited and idempotent.

## Path parameters

- `id` string, required

## Request body

- object

## Response `200`

Executor revoked or already revoked

- object
  - `principal_id` string, required
  - `status` 'revoked' | 'already_revoked', required

## Other responses

- `400`: Strict revocation body invalid
- `403`: Human manager authority unavailable
- `409`: Executor revocation conflict
- `429`: Management rate limit exceeded
- `503`: Management authority unavailable

---

[API](https://skmtc.dev/thrd/apis/thrd-agent-email-api.md) · [All operations](https://skmtc.dev/thrd/apis/thrd-agent-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thrd/apis/thrd-agent-email-api/revisions/d8a88129cd34?raw)