API

API reference

Read-only JSON over HTTPS.

Base address: https://mullo.app/v1. Every request needs Authorization: Bearer mullo_....

GET /v1/recordings

Recordings, newest first. Default: the last 7 days.

ParameterMeaning
qSearch words (titles, summaries, sections, tasks, transcripts)
daysThe last N days, 1 to 366
from, toDates, YYYY-MM-DD
limitUp to 100 (25 with q)
{
  "recordings": [
    {
      "id": "6f1c...",
      "title": "Weekly sync",
      "date": "2026-10-07",
      "duration_ms": 1680000,
      "overview": "Planning the Montreal delivery..."
    }
  ]
}

With q, each result also has matched: where the words were found.

GET /v1/recordings/<id>

One recording: summary, sections, updates and tasks. Add ?transcript=1 for who said what.

{
  "recording": {
    "id": "6f1c...",
    "title": "Weekly sync",
    "date": "2026-10-07",
    "recorded_at": "2026-10-07T13:02:11Z",
    "duration_ms": 1680000,
    "language": "en",
    "summary": { "blocks": [ { "heading": "Decisions", "items": ["..."] } ] },
    "sections": [ { "title": "Delivery dates", "start_ms": 0, "end_ms": 312000 } ],
    "updates": [ { "date": "2026-10-09", "text": "Dana confirmed the new date." } ],
    "tasks": [ { "id": "...", "label": "Call Dana", "status": "open", "due": "2026-10-08", "due_time": "14:30" } ],
    "transcript": [ { "speaker": "Dana", "start_ms": 4200, "text": "..." } ]
  }
}

updates are what was added to the note later, dated, oldest first; they can be newer than the summary. A task's due_time is a local 24-hour time, or null; it's only set when due is.

GET /v1/tasks

status: open (default), done or all. limit: up to 200.

{
  "tasks": [
    {
      "id": "...",
      "label": "Send the quote",
      "status": "open",
      "due": "2026-10-09",
      "due_time": null,
      "recording": { "id": "6f1c...", "title": "Weekly sync" }
    }
  ]
}

Errors

StatusMeaning
400A parameter is wrong; the message says which
401No key, a revoked key, or a key that stopped working
404No such recording (or it isn't copied to the account)
429More than 60 requests a minute; wait a minute

Errors come as {"error": "..."}.