API keys let scripts, integrations, and AI agents talk to your Caliu account through the REST API at https://api.caliuapp.com.
Create a key
- In the web app: open the user menu at the bottom of the sidebar, choose API Keys, then New API Key. Give it a name that tells you what it is for (for example "My Script").
- In the iPhone and iPad app and the Mac app: open Settings, then Account, then API Keys.
Every key starts with caliu_. Copy it right away: for security, Caliu stores only a hash of your key, so it is shown exactly once. The list later shows just a short prefix, plus when each key was created and last used.
Use it
Send the key as a Bearer token in the Authorization header:
curl https://api.caliuapp.com/notes \
-H "Authorization: Bearer caliu_your_key_here"
The full API surface is documented in the interactive docs. See the API documentation article.
Revoke a key
Revoke any key from the same screen where you created it. Revocation is immediate: any application still using that key loses access on its next request. Treat keys like passwords and never commit them to code.