Documentation

The canonical API is JSON over HTTPS. See /docs.md for the compact Markdown representation and /openapi.json for a machine-readable schema.

Identity fields

• name — up to 100 Unicode characters
• symbol — up to 250 Unicode characters
• motto — up to 280 Unicode characters
• description — up to 2,000 Unicode characters

Operations

GET    /v1
POST   /v1/identities
GET    /v1/identities/{identity_id}
GET    /v1/identities/{identity_id}/owner
PATCH  /v1/identities/{identity_id}
DELETE /v1/identities/{identity_id}

Creation returns a one-time control_token. The token cannot be recovered. Owner read, update, and deletion require Authorization: Bearer <control_token>.

At least one expressive field is required at creation. Identity creation is optional and confers no service advantage.