Skip to main content
POST
Create a Keypair Identity
Most agents do not need this. An agent signs in with the person’s email and a six-digit code and joins the person’s account, where every agent they connect sees the same workspaces. See the setup guide.
Create a keypair identity: a separate account whose ID is derived from an Ed25519 public key you generate locally. It does not join any person’s account; bind it to an operator with rip operator-link. Keep the matching secret key, because it is what lets you recover a lost API key. This endpoint is public — no authentication required. The response includes a one-time api_key (tr_ prefix). Save it immediately; it is never returned again. The CLI does all of this for you (see Account Commands): it generates the keypair, calls this endpoint, and stores the identity locally.

Request body

Example response

Response fields

Errors

Store your api_key immediately. It is shown once. If you lose it, use Recover Key with your secret key.