Disconnect an agent

POST/v1/agents/{agentId}/disconnect

Revokes every live mandate of yours that names the agent and ends its connections. Keelson refuses its countersigns from now on; purchases already countersigned may still be captured. With client, only that app, of the apps acting through the agent: the mandates you approved for it, its requests, its OAuth grant and refresh tokens, and the access tokens it holds for you. Apps acting through Keelson's hosted operator are disconnected this way; without client, the hosted operator ends only your mandates of it that no app holds (its Unknown app row).

Path parameters

agentIdstringRequired

Query parameters

clientstring

Headers

idempotency-keystringRequired
Idempotency-KeystringRequired: 1 to 255 characters. A retry with the same key returns the first answer.

Responses

200Disconnected
401Not signed in
404No agent of yours with this id

200 response

revokedintegerRequired: Mandates stopped.

curl -X POST https://api.keelson.finance/v1/agents/{agentId}/disconnect \
  -H 'idempotency-key: <idempotency-key>' \
  -H "idempotency-key: $(uuidgen)"

const res = await fetch("https://api.keelson.finance/v1/agents/{agentId}/disconnect", {
  method: "POST",
  headers: {
    "idempotency-key": "<idempotency-key>",
    "idempotency-key": crypto.randomUUID(),
  },
});
const data = await res.json();

Response · shape from the schema

{
  "revoked": 0
}