📋 Agent Registry API¶

The CapiscIO Registry provides a REST API for managing agents, issuing badges, and resolving DIDs.

Core Features¶

The registry provides:

• Agent Management — CRUD operations for agent records
• Badge CA — Issue and verify trust badges
• DID Resolution — Resolve did:web identifiers
• Public Verification — Check badge and agent status

API Endpoints¶

Public Endpoints (No Authentication)¶

DID Resolution¶

GET /agents/{id}/did.json

JWKS (Public Keys)¶

GET /.well-known/jwks.json

Badge Status¶

GET /v1/badges/{jti}/status

Agent Status¶

GET /v1/agents/{id}/status

Revocation List¶

GET /v1/revocations

Authenticated Endpoints (Clerk Auth)¶

List Your Agents¶

GET /v1/agents
Authorization: Bearer {clerk_token}

Create Agent¶

POST /v1/agents
Authorization: Bearer {clerk_token}
Content-Type: application/json

{
  "name": "My Agent",
  "description": "Agent description",
  "agent_card": { ... }
}

Get Agent¶

GET /v1/agents/{id}
Authorization: Bearer {clerk_token}

Update Agent¶

PUT /v1/agents/{id}
Authorization: Bearer {clerk_token}

Delete Agent¶

DELETE /v1/agents/{id}
Authorization: Bearer {clerk_token}

Issue Badge¶

POST /v1/agents/{id}/badge
Authorization: Bearer {clerk_token}

Revoke Badge¶

POST /v1/badges/{jti}/revoke
Authorization: Bearer {clerk_token}

Create PoP Challenge (RFC-003)¶

POST /v1/agents/{did}/badge/challenge

Submit PoP Proof (RFC-003)¶

POST /v1/agents/{did}/badge/pop

Enterprise Deployment¶

For enterprise customers, capiscio-server is available for on-premises deployment with commercial licensing.

Features:

• Private agent registry
• Self-managed Badge CA
• Custom trust policies
• Air-gapped environments

Your agents get DIDs like:

did:web:your-company.com:agents:internal-bot

Contact Sales

Next Steps¶