Identity
Create public profiles, look up public identity data, discover public keys, and verify signatures.
Developer platform
TRI1 API lets developers use TRI1 identity, public-key discovery, contacts, and secure communication infrastructure without exposing private keys or decrypted message bodies.
v1
/v1/identity/:triId/status200/v1/identity/:triId/public-key200/v1/identity/create201/v1/developer/me/tokensscopedNever expose, store, log, transmit, or reconstruct private keys, seed phrases, backup keys, recovery keys, or decrypted message bodies.
Create public profiles, look up public identity data, discover public keys, and verify signatures.
Use TRI1 contact and conversation infrastructure through scoped, token-protected routes.
Responses stay public-field only. Private-key-like material is rejected before persistence.
| GET | /health | Public service health check |
| GET | /ready | Public readiness check for auth and database connectivity |
| POST | /v1/identity/create | Create or update a public identity profile |
| GET | /v1/identity/me | Confirm the authenticated API key context |
| GET | /v1/identity/:triId | Fetch public identity fields |
| POST | /v1/identity/verify | Verify public identity signature material |
| GET | /v1/identity/:triId/public-key | Fetch public key material only |
| GET | /v1/identity/:triId/status | Fetch existence and classification status |
| POST | /v1/agents | Create an AI agent as a TRI1 identity with agent metadata |
| GET | /v1/agents/:agentId/contact-card | Return public AI contact fields for app import |
| GET | /v1/agents/:agentId/inbox | Read encrypted messages for an agent runtime |
| POST | /v1/agents/:agentId/rooms/:roomId/messages | Send encrypted TRI1 agent messages only |
| GET | /api/tri/contacts | Fetch TRI1 contacts through the core API |
| POST | /api/tri/contacts/upsert | Create or update contact metadata |