---
title: "Admin Kill Tenant Agents"
method: POST
path: "/admin/tenants/{id}/agents/kill"
tags: ["admin"]
---

# Admin Kill Tenant Agents

`POST /admin/tenants/{id}/agents/kill`

## Request

- Base URL: `https://api.instruxi.dev/api/v1/enforcer`
- URL: `https://api.instruxi.dev/api/v1/enforcer/admin/tenants/{id}/agents/kill`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `X-API-Key`

The kill switch for a platform admin (cross_tenant) against any tenant; same effect as the tenant's own.

## Path parameters

- `id` string, required

## Request body

- InternalDeliveryHttpHandlerAgentReasonRequest
  - `reason` string

## Response `200`

OK

- InternalDeliveryHttpHandlerAgentKillResponse
  - `data` EnforcerV3InternalDomainAgentKillResult
    - `clients_disabled` integer
    - `credentials_revoked` integer
    - `suspended` integer
  - `success` boolean

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/instruxi/apis/enforcer-api.md) · [All operations](https://skmtc.dev/instruxi/apis/enforcer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/instruxi/apis/enforcer-api/revisions/fa82bc1becc0?raw)
