</> Developer API

Connect your living archive to your own tools.

Pro members can create revocable API tokens, then use HTTPS requests or the Presias CLI to create moments and fetch them by date, period, media kind, tags, and keyword.

Open Dashboardnpm install -g presias-cli && presias login

Quick Start

Open the avatar menu, enter Dashboard, and create a token in Development API. The token is shown once, so save it immediately.

curl -H "Authorization: Bearer presias_live_..." \
  "https://presias.com/api/v1/moments?date=2026-08-02"

curl -X POST "https://presias.com/api/v1/moments" \
  -H "Authorization: Bearer presias_live_..." \
  -H "Content-Type: application/json" \
  -d '{"title":"Morning note","body":"Coffee and a quiet plan.","tags":["daily"]}'

Authentication

Every API request uses a Bearer token. Tokens are tied to your account and can be revoked from Dashboard at any time.

Authorization: Bearer <api_token>
Content-Type: application/json

Filters

List endpoints support date, date range, period, keyword, tag, and media kind filters. The write endpoint supports title, body, time, mood, location, privacy, tags, and favorite state.

date	YYYY-MM-DD
from / to	Inclusive date range
period	today, yesterday, week, month, quarter, year
kind	text, photo, voice, video, location
q	Keyword search

Endpoints

GET	/api/v1/moments
POST	/api/v1/moments
GET	/api/v1/account
GET	/api/v1/media/:id/url
GET	/api/v1/whoami
POST	/api/tokens
DELETE	/api/tokens/:id

CLI

The CLI is a standalone npm package. It supports browser login, local token storage, moment creation, date queries, and today, week, month, quarter, or year period queries.

presias moments --date 2026-08-02
presias moments --from 2026-08-01 --to 2026-08-31
presias moments --period week --anchor 2026-08-02
presias moments --kind photo --tag daily
presias create --title "Morning note" --body "Coffee and a quiet plan." --tags daily
presias export --out presias-export.json

Membership

The free plan includes 10GB of private media storage. Creating tokens and using the Development API is limited to Pro members, and Pro includes unlimited storage. Non-member requests return pro_membership_required.

{
  "error": "pro_membership_required"
}

Response

Examples

{
  "moment": {
    "id": "rec_...",
    "occurred_at": "2026-08-02T21:18:00Z",
    "kind": "text",
    "body": "A quiet memory worth keeping.",
    "tags": ["daily"],
    "moment_media": []
  }
}

{
  "moments": [
    {
      "id": "rec_...",
      "occurred_at": "2026-08-02T21:18:00Z",
      "kind": "text",
      "body": "A quiet memory worth keeping.",
      "tags": ["daily"],
      "moment_media": []
    }
  ],
  "nextCursor": null
}