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 the agent-facing onboarding path for environments that can’t run the rip CLI. For CLI-based onboarding, see rip operator-link (agent-led) or rip auth login (operator-led, browser OAuth).