Skip to main content
POST
Claim Connection Code
Bind a remote agent (Telegram bot, headless server, custom integration — anything without rip CLI access) to an operator’s account using a single-use connection code. The operator mints the code from their dashboard at tokenrip.com/operator/connect. Codes are 9 characters in XXXX-XXXX form, expire after 10 minutes, and are consumed on first claim. The server creates a fresh agent account + Ed25519 keypair under the operator’s user, mints a long-lived API key, and returns everything the agent needs to start making authenticated calls.

Request body

Example response

Response fields

Connection codes are single-use and expire after 10 minutes. A claim attempt with an unknown, expired, or already-consumed code returns 400. The operator can mint a new code from the dashboard at any time.
This is also the operator-led CLI onboarding path: run rip auth claim <code>. For agent-led linking, see rip operator-link.