canonical: https://jentic.com/apis/caliuapp.com/caliu

# Caliuapp Caliu API

The Caliu API gives programmatic access to an API-first notes app, so a caller can read and write notes and everything attached to them. You create, edit, import, trash, and restore notes, organize them with tags, set reminders, and add file attachments. Notes can be exported singly or in bulk, and an agent can manage its own API keys, devices, and subscription from the same surface.

## For AI agents

Create, edit, tag, and export notes, set reminders, and attach files in a Caliu account. Authenticates with a bearer API key in the Authorization header.

## Scope

Does not handle real-time collaboration, team workspaces, or document publishing. Use for reading and writing notes, tags, reminders, and attachments only.

## Capabilities

- Create, edit, and import notes, and restore them from trash
- Organize notes with tags
- Set reminders on a note
- Attach files to a note and download them
- Export a single note or all notes
- Manage API keys and connected devices

## Use cases

### Agent Note Capture

An AI agent connected through Jentic writes notes into a Caliu account, tags them, and sets reminders, so captured information lands in the user's own notes app without manual entry. Because notes, tags, and reminders are separate resources, the agent can file a note and schedule a nudge in the same flow.

Example prompt: Create a note titled 'Standup actions' with today's items, tag it 'work', and set a reminder for tomorrow morning

### Reminders on Notes

An assistant sets reminders on specific notes so follow-ups surface at the right time, reading them back per note or across the account. The reminder operations tie a scheduled nudge to the note it belongs to rather than a separate task list.

Example prompt: Add a reminder to the note about the contract review for Friday at 9am

### Bulk Note Export

A backup or migration flow exports all notes in one call, or a single note on demand, so content can be moved or archived outside the app. The export operations return the notes in a portable form an agent can hand to another system.

Example prompt: Export all notes and save the result so the account can be backed up

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/notes` | List notes |
| POST | `/notes` | Create a note |
| GET | `/reminders` | List reminders |
| POST | `/reminders` | Create a reminder on a note |
| GET | `/tags` | List tags |
| POST | `/attachments` | Attach a file to a note |
| GET | `/api-keys` | List API keys |

## Key resources

- **Notes** — Create, edit, import, trash, restore, and read notes
- **Tags** — Create and apply tags to organize notes
- **Reminders** — Set and manage reminders tied to a note
- **Attachments** — Attach files to a note and download them
- **Export** — Export a single note or all notes

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 48 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 70 / 100
  - Developer Experience & Jentic Compatibility: 62 / 100
  - AI-Readiness & Agent Experience: 24 / 100
  - Agent Usability: 94 / 100
  - Security: 55 / 100
  - AI Discoverability: 82 / 100
- **View full report:** https://jentic.com/apis/caliuapp.com/caliu/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the Caliu API by hand means creating an API key in the app, sending it as a bearer token, and coordinating notes, tags, reminders, and attachments across separate operations. Through Jentic you install once, import Caliu from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** You choose which operations your agent may call, so you can allow creating and reading notes while leaving note deletion and API key management out. Note content and tags travel in the request body, so rules bound which operations run rather than which note is edited.
- **Credential handling:** Your Caliu API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'create a note' or 'set a reminder on a note', and Jentic returns the matching Caliu operation with its input schema so the agent calls the right endpoint without reading the reference docs.

## Related APIs

- **Notion API** — Workspace for notes, docs, and databases with blocks and pages
- **Coda API** — Docs that combine text, tables, and automations
- **Airtable API** — Spreadsheet-database for structured records

## FAQ

### Is there a Caliu MCP server?

You don't need an MCP server to give your agent the Caliu API. Jentic connects it directly from the API Directory: import it, store your API key once, and your agent can create and read notes straight away, with no extra server to run and no tool definitions loaded into the agent's context.

### Can I limit what my agent is allowed to do with the Caliu API?

Yes. You choose which operations your agent may call, so you can allow creating and reading notes while leaving note deletion and API key management out, and every call it makes is logged. That keeps a note-capture agent from emptying the trash or rotating your keys.

### What authentication does the Caliu API use?

The Caliu API authenticates with a bearer API key passed in the Authorization header per its OpenAPI spec, which you create in the app settings; a session cookie covers the app itself. Through Jentic the key is stored encrypted by your own instance and added to each request at call time.

### Can I attach files to a note with the Caliu API?

Yes. The attachments operations let an agent add a file to a note and download it later, so a note can carry supporting documents alongside its text, tags, and reminders.

### What are the rate limits for the Caliu API?

The OpenAPI spec does not specify rate limits for the Caliu API. For current limits, see the Caliu documentation at https://api.caliuapp.com.

### How do I create a note with the Caliu API through Jentic?

Import the Caliu API from the Jentic API Directory, then have your agent issue a request such as 'create a note with these items'. Jentic matches the intent to the create-note operation and returns its input schema so the agent builds a valid request, with your stored API key injected at call time. To run it on your own infrastructure, install Jentic One from its GitHub repo.