List and disconnect agents - Sumvin

Private preview: this is rolling out and may not be available on your account yet.

First-party only today. These calls need a personal access token, which isn’t yet open to third-party apps. See Sign in.

Each agent a person connects gets its own agent identity under their Sigil. The person can see every one and disconnect any of them. Only the person can do this. A request made on their behalf, such as one carrying a Stamped Mandate token, is refused, so one agent can’t discover or disconnect another, or itself.

List connected agents

import { listAgentIdentities, unwrap } from "@sumvin/sdk";

const { data } = unwrap(await listAgentIdentities({ client }));
for (const agent of data) {
  console.log(agent.id, agent.client_id, agent.status, agent.created_at);
}

Field	Means
`id`	The agent identity’s identifier. Use it to disconnect.
`client_id`	The application the agent was connected through.
`status`	`pending` while it is being set up, `active` when live, `failed` if setup didn’t finish, `retired` once disconnected.
`generation`	How many times this application has been connected. It goes up each time it is connected again after a disconnect.
`created_at`	When it was connected, in epoch milliseconds.

Disconnect an agent

import { revokeAgentIdentity } from "@sumvin/sdk";

const { error } = await revokeAgentIdentity({ client, path: { external_id: agent.id } });

The agent stops being honoured straight away, including any access it already held. Disconnecting an agent that is already disconnected changes nothing.