---
title: "Import notes"
method: POST
path: "/notes/import"
tags: ["Notes"]
---

# Import notes

`POST /notes/import`

## Request

- Base URL: `https://api.caliuapp.com`
- URL: `https://api.caliuapp.com/notes/import`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `caliu_session`

Bulk import notes from .md, .zip, .bear2bk, .textpack, or .json files. Max 500 notes.

## Response `200`

Import results

- object
  - `imported` number, required
  - `skipped` number, required
  - `warnings` string[], required
  - `source` string

## Other responses

- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/caliuapp/apis/caliu-api.md) · [All operations](https://skmtc.dev/caliuapp/apis/caliu-api/llms.txt) · [OpenAPI document](https://skmtc.dev/caliuapp/apis/caliu-api/revisions/1ba4d3f687fe?raw)