Tokens, scopes, limits and errors

Tokens and scopes

Sign in, open Settings → API access and create a personal token (rlf_…). Choose its scopes when you create it; revoke it there any time. Send it on every request:

Authorization: Bearer rlf_your_token_here

`read`	Reads and calculations: the tools that change nothing (`guide`, `get`, `list`, the analysis tools, `strategy`, `upgrade_link`).
`write`	Everything that saves, changes, shares or deletes (`models`, `datasets`, `rbd`, `uploads`, `rcm`, `sharing`, `fleet`), and photo uploads.
`ingest`	Push data only (“Push data” in the app): the ingest routes and model import. An ingest-only token can never read your analyses.

No token can reach your account, billing or tokens. Tokens made before scopes existed keep all three. The base URL is https://reliafy.com/api/v1.

Limits and errors

Rate limit: 120 requests a minute per account. Ingest routes take at most 5,000 rows a request.
Calls are gated exactly as over the Claude connector: Pro accounts get every tool with no monthly allowance, and a few heavy calculations can run at once per account.
Every refusal is JSON, {"detail": "…"}, said plainly.

`401`	No token, or a wrong, expired or revoked one.
`402`	Needs Pro: a token on an account without Pro, or a Pro-only tool.
`403`	Outside the token’s scopes (for example a write with a read-only token).
`404`	No such tool, action or item, or one you can’t see.
`422`	The arguments: the detail says which and why.
`429`	The rate limit, the monthly allowance, or too many calculations running at once.
`503`	Busy: try again in a minute.
`504`	The call ran out of time.