POST/api/v1/sandbox/agents/{id}/revoke

Agents

Revoke sandbox agent

Revoke a sandbox agent's mandate straight away.

Sandbox APIhttps://sandbox-api.nuvante.io

Sets revokedAt on the agent. Any transaction submitted with this agentId after that is rejected at initiation. Needs the manageOwnAgents capability (own participant only).

Parameters

Revoke sandbox agent parameters
FieldTypeRequiredDescription
idstring · pathYesThe `agentId` you got back when you minted the agent.

Responses

200Agent revoked.
Create a sandbox API key

Request

curl --request POST \
  --url 'https://sandbox-api.nuvante.io/api/v1/sandbox/agents/agt_a23e4567-e89b-42d3-a456-426614174040/revoke' \
  --header 'Authorization: Bearer nvt_sandbox_your_key' \
  --header 'Accept: application/json'

Response

{
  "data": {
    "agentId": "agt_a23e4567-e89b-42d3-a456-426614174040",
    "revokedAt": "2026-08-19T14:00:00.000Z"
  },
  "meta": {
    "commandId": "e23e4567-e89b-42d3-a456-426614174042"
  }
}