Sign in
Agents

Revoke an agent

Sets status to REVOKED and revokes every key on the agent. Irreversible. Submitted transfers continue; new writes with its keys are denied.

delete/v1/agents/{id}

Path parameters

idstring required

Headers

X-API-Keystring

API key

Response

idstring required
namestring required
descriptionstring nullable required
customerIdstring required
sourceAccountIdstring required
allowedDestinationAccountIdsstring[] nullable required
status'ACTIVE' | 'PAUSED' | 'REVOKED' required
metadataobject required
createdAtstring date-time required
updatedAtstring date-time required

Example response

{
  "id": "agt_abc123",
  "name": "Procurement Agent",
  "description": "Buys supplies",
  "customerId": "cus_abc123",
  "sourceAccountId": "vba_agent_balance",
  "allowedDestinationAccountIds": [
    "eba_vendor456"
  ],
  "limits": {
    "currency": "USD",
    "perTransaction": "100000",
    "perDay": "500000",
    "perMonth": "1000000"
  }
}

Changes