> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rippit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Temporary accounts

> Start a Rippit account from an agent without an email, then claim it with an emailed code to keep it.

If an agent needs a Rippit account and the person isn't around, it starts a temporary one now. The person claims it later if they want to keep it.

Temporary accounts are only for people with no Rippit account. If the person has one, or isn't sure, run `rippit login` instead. A temporary account can't be moved into an existing account later.

## Quick start

```sh theme={null}
rippit start
rippit claim --wait
```

`rippit start` creates the account and signs in the current CLI profile. When the person is ready to keep it, `rippit claim --wait` opens the claim page in their browser and prints the link, so you can also show it to them. It waits until they claim the account, then runs `rippit login` so they can approve the CLI as the new owner. Pass `--no-browser` to print the link without opening it, for example when the person is on another machine.

Both commands take `--format json`. `rippit claim --wait --format json` prints a new link only when it makes one, then one object with the outcome and the `next_command` to run.

## Before the claim

| | Before the claim | After the claim |
| - | - | - |
| Connect data sources and upload data | Yes | Yes |
| Open Rippit in a browser | No | Yes |
| Invite people | No | Yes |
| Share public links | No | Yes |
| Create API keys | No | Yes |
| Send email from Rippit | No | Yes |
| AI credit | \$5 | Free plan |
| Deletion | After 14 days | Kept |

A blocked action returns `account_unclaimed`. Give the person the claim link instead of retrying.

## Claim an account

1. Open the claim link. Each link works once and expires after an hour; `rippit claim` prints a new one.
2. Enter your email. Rippit emails a 6-digit code that expires in 15 minutes.
3. Enter the code. The account becomes yours, its deletion date is removed and you're signed in.

Claiming signs the CLI out. Its tokens stop working right away and return `temporary_account_claimed`. Run `rippit login` and approve it in the browser, or let `rippit claim --wait` do it.

## If you already have a Rippit account

If the email you enter already has a Rippit account, the claim page warns you before going further. Continuing closes the temporary account, and nothing in it moves to your account. You then sign in to your own account, and `rippit login` connects the CLI to it. The CLI's next request returns `temporary_account_closed`.

If you claim a temporary account and later remember another Rippit account, the two stay separate and can't be merged. Delete the one you don't need with **Delete account** on its Billing page.

## Expiry

An unclaimed account is deleted after 14 days, on the date `rippit claim` prints. Deletion ends sign-in and removes stored third-party credentials, the same as **Delete account**. After that, the CLI returns `temporary_account_expired`, or `invalid_grant` once Rippit has finished cleaning up the account. Either way, `rippit start` replaces the profile with a new temporary account.

At most 5 temporary accounts can start from one network address per day, and 100 in total. Past that, `rippit start` returns `daily_limit_reached`.

## Errors

With `--format json`, a failed command prints one JSON shape to stderr:

```json theme={null}
{"error": {"code": "temporary_account_closed", "message": "This temporary account was closed because its owner already has a Rippit account. Run `rippit login` to use that account.", "retryable": false}}
```

Use `code` for control flow and show `message` to the person. Without `--format json`, the CLI prints the message followed by `(code: ...)`.

| Code | Meaning |
| - | - |
| `account_unclaimed` | The action needs a claimed account. Give the person the claim link. |
| `daily_limit_reached` | Too many temporary accounts started today. Retry tomorrow, or use `rippit login`. |
| `temporary_account_claimed` | The account was claimed. Run `rippit login`. |
| `temporary_account_closed` | The person already had a Rippit account, so this one was closed. Run `rippit login`. |
| `temporary_account_expired` | Nobody claimed the account in time. Run `rippit start` for a new one, or `rippit login`. |

## Resources

* [Rippit CLI](https://docs.rippit.com/cli.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.