Revocation & Kill Switch

Instantly revoke, suspend, or reinstate agents. Revocation takes effect immediately — all subsequent verification calls for that agent will be denied with zero propagation delay.

Revocation Commands

POST/api/revokeAPI Key

Permanently revoke an agent. All future intents will be denied immediately.

agent_idstring*

The DID of the agent to revoke

reasonstring

Human-readable reason for audit trail

curl

curl -X POST https://aip.synthexai.tech/api/revoke   -H "X-API-Key: kya_your_key"   -H "Content-Type: application/json"   -d '{"agent_id": "did:web:yourco.com:agents:rogue-bot", "reason": "compromised credentials"}'

# {"agent_id": "did:web:...", "status": "revoked", "reason": "compromised credentials"}

POST/api/suspendAPI Key

Temporarily suspend an agent for 1 hour. Auto-reinstates after expiry.

curl

curl -X POST https://aip.synthexai.tech/api/suspend   -H "X-API-Key: kya_your_key"   -H "Content-Type: application/json"   -d '{"agent_id": "did:web:yourco.com:agents:my-bot", "reason": "investigating anomaly"}'

# {"agent_id": "did:web:...", "status": "suspended",
#  "suspended_until": "2026-02-14T15:30:00+00:00"}

POST/api/reinstateAPI Key

Reinstate a previously revoked or suspended agent.

curl

curl -X POST https://aip.synthexai.tech/api/reinstate   -H "X-API-Key: kya_your_key"   -H "Content-Type: application/json"   -d '{"agent_id": "did:web:yourco.com:agents:my-bot"}'

# {"agent_id": "did:web:...", "reinstated": true, "status": "active"}