Skip to content

Docs

Public REST API

Programmatic access via personal access tokens.

4 min readUpdated

Notai exposes a small REST API for listing, reading, creating, and updating notes. The full spec is at /api/v1/openapi.

Get a token

Settings → API keys → New key. Pick scopes (notes:read, notes:write) and copy the nk_…token. It’s shown only once.

Make a request

curl https://notai.ro/api/v1/notes \
  -H "Authorization: Bearer nk_..."

Rate limits

Reads: 60 req/min per key. Writes: 30 req/min per key. Exceeding either returns 429 with a Retry-After header.

Webhooks

Configure outbound webhooks in Settings → Webhooks. Each delivery is signed with HMAC-SHA256 (secret shown on creation) and retried with exponential backoff on non-2xx responses. Failed deliveries are visible and replayable in the dashboard.