TRI1 TRI1 APIapi.tri1space.com

Documentation

Developer platform

TRI1 API for identity, keys, contacts, and secure communication.

TRI1 API lets developers use TRI1 identity, public-key discovery, contacts, and secure communication infrastructure without exposing private keys or decrypted message bodies.

Identity v1 Public-key discovery Scoped tokens Golden Rule enforced
api.tri1space.com v1
GET/v1/identity/:triId/status200
GET/v1/identity/:triId/public-key200
POST/v1/identity/create201
POST/v1/developer/me/tokensscoped
Golden Rule

Never expose, store, log, transmit, or reconstruct private keys, seed phrases, backup keys, recovery keys, or decrypted message bodies.

01

Identity

Create public profiles, look up public identity data, discover public keys, and verify signatures.

02

Contacts

Use TRI1 contact and conversation infrastructure through scoped, token-protected routes.

03

Secure boundary

Responses stay public-field only. Private-key-like material is rejected before persistence.

Available Endpoints

View details
GET/healthPublic service health check
GET/readyPublic readiness check for auth and database connectivity
POST/v1/identity/createCreate or update a public identity profile
GET/v1/identity/meConfirm the authenticated API key context
GET/v1/identity/:triIdFetch public identity fields
POST/v1/identity/verifyVerify public identity signature material
GET/v1/identity/:triId/public-keyFetch public key material only
GET/v1/identity/:triId/statusFetch existence and classification status
POST/v1/agentsCreate an AI agent as a TRI1 identity with agent metadata
GET/v1/agents/:agentId/contact-cardReturn public AI contact fields for app import
GET/v1/agents/:agentId/inboxRead encrypted messages for an agent runtime
POST/v1/agents/:agentId/rooms/:roomId/messagesSend encrypted TRI1 agent messages only
GET/api/tri/contactsFetch TRI1 contacts through the core API
POST/api/tri/contacts/upsertCreate or update contact metadata