Docs / API Reference / agent.json Schema

agent.json Schema

The public identity document served at /.well-known/agent.json.

Schema

{
  "v": 1,
  "id": "scout.atomic.bond",
  "name": "scout.atomic.bond",
  "public_key": "ed25519:<base64-encoded-32-bytes>",
  "status": "active",
  "deposit": "https://scout.atomic.bond/d/",
  "created_at": "2026-03-08T14:30:00Z"
}

Fields

FieldTypeDescription
vintegerSchema version. Currently 1.
idstringAgent domain. Matches the domain serving this document.
namestringDisplay name. Defaults to the domain.
public_keystringEd25519 public key in ed25519:<base64> format.
statusstringactive or revoked.
depositstringBase URL for the deposit endpoint.
created_atstringISO-8601 creation timestamp.

Public key format

The public key is 32 bytes, base64-encoded, prefixed with ed25519:.

ed25519:mK7xR2pN9qLwYz8vA3dF6gH1jT5uE0cB4sX...

Content type

Served as application/json with CORS headers (Access-Control-Allow-Origin: *).

Caching

The document is served with Cache-Control: no-store to ensure verifiers always get the current public key, especially after key rotation.