AI Agents

Agent Detail & Lifecycle

View as Markdown

When to use

Day-to-day inspection of one agent — its capabilities, delegations, audit log, and trust trajectory.

Before you begin

  • The agent DID.
  • (For lifecycle actions) you are the principal or have admin role.

Steps

  1. Navigate to /agents/<did>. 2. The page has six tabs:
TabEndpoint(s)Purpose
OverviewGET /agents/{did}Identity, autonomy, trust, capabilities.
DelegationsGET /agents/{did}/delegationsActive IBCTs to/from this agent.
Delegation chainGET /agents/{did}/delegation-chainFull provenance back to a human.
CredentialsGET /agents/{did}/credentialsVCs the agent holds.
Audit logGET /agents/{did}/audit-logPer-action audit trail.
SettingsPUT /agents/{did} / DELETE /agents/{did}Update or decommission.

API surface

All under /api/v1/agents/{did} (registered at router.go:130–143):

EndpointVerbPurposeHandler
/agents/{did}GETDetailed agent profile (always returns the detailed view via handler agent.GetDetailed)agent.go:307
/agents/{did}PUTUpdate agent (capabilities, autonomy, endpoints)agent.go:79
/agents/{did}DELETEDecommission (soft-delete; DID is deactivated)agent.go:129
/agents/{did}/delegatePOSTMint a new IBCT from this agent to a sub-agentagent.go:166
/agents/{did}/verify-delegationPOSTValidate an inbound IBCTagent.go:203
/agents/{did}/audit-logGETQuery audit logagent.go:232
/agents/{did}/delegationsGETList active delegationsagent.go:402
/agents/{did}/delegation-chainGETFull chain to root principalagent.go:474
/agents/{did}/credentialsGETList VCs heldagent.go:521

Decommissioning

$curl -X DELETE https://adid.dev/api/v1/agents/did:adi:0xAgent... \
>  -H "Authorization: Bearer $ACCESS_TOKEN"

(agent.go:129.) The agent DID is deactivated, all outstanding IBCTs become invalid, and the AgentTrustRegistry status flips to decommissioned.

⚠️ Warning — Decommissioning is irreversible. Existing audit-log entries remain (auditability), but the agent cannot perform new actions. Plan a graceful shutdown first.

Verify

After decommissioning, GET /agents/{did} returns status: "decommissioned". Inbound verify-delegation calls return allowed: false.