Revoke an agent. Idempotent. Kills grants, sessions, and in-flight Use. Record stays for audit.

POST/v1/agents/{name}/revoke

Authorization

AuthorizationBearer token (JWT) · headerrequired

Hydra JWT. Identity is the bound agent or a Keto member human. The host is not identity.

Path parameters

namestringrequired

Responses

200Revoked agent. No token or secret.

kindstringrequired

idstringrequired

org_idstringrequired

ownerOwner

Show properties

kindstringrequired

idstringrequired

revoked_atstring<date-time>

Set when the agent is revoked. Record stays for audit.

400bad request

401missing or invalid Bearer

403not owner

Request

curl -X POST "https://veil.nyc/v1/agents/string/revoke" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://veil.nyc/v1/agents/string/revoke", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.post(
    "https://veil.nyc/v1/agents/string/revoke",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "kind": "string",
  "id": "string",
  "org_id": "string",
  "owner": {
    "kind": "string",
    "id": "string"
  },
  "revoked_at": "2024-01-01T00:00:00Z"
}