Minnes API.

GET /v1/me

Whose key this is, or who's signed in

The organisation the key reads for, and the key as its admins named it; or the person signed in, which of their people in Minne is them (me: the speaker who's them in their meetings), and their organisation. The call to check a key or a sign-in works.

• 200 The key's organisation.
• 401 No key or token, one that isn't Minne's, a key revoked or of an organisation that ended, or a sign-in ended or disconnected.
• 429 The key made 600 requests this minute. Wait the seconds Retry-After says.

{
  "type": "organisation",
  "id": "o_01JC2Q5Z8K3M7N9P1R4T6V8X0Y",
  "name": "Nordljus AB",
  "key": {
    "id": "k_01JC2Q8B0D2F4H6J8K0M2N4P6Q",
    "name": "Slack bot",
    "created_at": "2026-11-03T10:00:00+00:00"
  }
}

GET /v1/meetings

List meetings

The meetings shared with the organisation, or a person's own, the newest first by when they started, a page at a time: follow next_cursor until there's none. A page can hold fewer than limit, even none, when there's more to come: it reads at most 1,000 meetings to fill itself. Each meeting has its id, title, times and who shared it; get one with GET /v1/meetings/{id} for its summary.

• 200 A page of meetings.
• 400 A parameter isn't what it should be; error says which.
• 401 No key or token, one that isn't Minne's, a key revoked or of an organisation that ended, or a sign-in ended or disconnected.
• 429 The key made 600 requests this minute. Wait the seconds Retry-After says.

{
  "meetings": [
    {
      "id": "mtg_01JBX5Q7M2A8N4R6T0V2W4Y6Z801M5JHFTFH01KXC4V2P9JNFA54",
      "title": "Acme renewal",
      "started_at": "2026-11-03T09:00:12Z",
      "ended_at": "2026-11-03T09:44:57Z",
      "duration": 2685.4,
      "language": "en",
      "shared_by": "Ada Lindqvist",
      "shared_at": "2026-11-03T11:02:40+00:00",
      "updated_at": "2026-11-03T11:02:40+00:00"
    }
  ],
  "next_cursor": "eyJvcmciOiAib18wMUpDMlE1WjhLM003TjlQMVI0VDZWOFgwWSJ9"
}

GET /v1/meetings/{id}

Read a meeting

A shared meeting as it is now: who spoke, and its summary as one Markdown page with everyone's name. A meeting that isn't shared with the organisation (any more) is a 404, the same as one that never was.

• 200 The meeting.
• 401 No key or token, one that isn't Minne's, a key revoked or of an organisation that ended, or a sign-in ended or disconnected.
• 404 No meeting with this id is shared with the organisation now.
• 429 The key made 600 requests this minute. Wait the seconds Retry-After says.

{
  "id": "mtg_01JBX5Q7M2A8N4R6T0V2W4Y6Z801M5JHFTFH01KXC4V2P9JNFA54",
  "title": "Acme renewal",
  "started_at": "2026-11-03T09:00:12Z",
  "ended_at": "2026-11-03T09:44:57Z",
  "duration": 2685.4,
  "language": "en",
  "shared_by": "Ada Lindqvist",
  "shared_at": "2026-11-03T11:02:40+00:00",
  "updated_at": "2026-11-03T11:02:40+00:00",
  "speakers": [
    {
      "speaker": "S1",
      "name": "Ada Lindqvist",
      "talk_time": 1102.0
    },
    {
      "speaker": "S2",
      "name": "Peter Larsson",
      "talk_time": 811.5
    }
  ],
  "summary": "# Acme renewal\n\n2026-11-03 · 45 min · with Ada Lindqvist, Peter Larsson\n\n**Overview.** Acme renews for two years …\n"
}

GET /v1/meetings/{id}/transcript

Read a meeting's transcript

What was said, line by line, with each speaker's name and the seconds into the meeting, a page at a time. from and to read one part of it, such as a topic's times from its summary.

• 200 A page of the transcript, at most about 40,000 characters.
• 400 A parameter isn't what it should be; error says which.
• 401 No key or token, one that isn't Minne's, a key revoked or of an organisation that ended, or a sign-in ended or disconnected.
• 404 No meeting with this id is shared with the organisation now.
• 429 The key made 600 requests this minute. Wait the seconds Retry-After says.

{
  "lines": [
    {
      "speaker": "Ada Lindqvist",
      "start": 12.31,
      "end": 15.02,
      "text": "Thanks for making the time, Peter."
    },
    {
      "speaker": "Peter Larsson",
      "start": 15.4,
      "end": 19.8,
      "text": "Of course. Shall we start with the renewal?"
    }
  ]
}

GET /v1/search

Search meetings by meaning

The meetings closest in meaning to q, best first: a key's organisation's shared ones, or a person's own and their organisation's (scope). Each has up to 3 passages of its summary that matched, as it reads now. Get a meeting's whole summary with GET /v1/meetings/{id}, and what was said with its transcript.

It searches the summaries, in Swedish or English whichever the query is in: what each meeting was about, its topics, what was decided and who does what, and who was there. Not the transcripts' every word.

Ask it a question, as you'd ask a colleague who was there, with the names and specifics you know. Measured on 18 needs, each written several ways (evals/search), the meeting wanted came first:

• 94% of the time for a question: "What did Erik tell the company at the all-hands about the Atlas delay?"
• 78% for a description: "all-hands where Erik explained why Atlas was delayed"
• 56% for a bare topic: "all-hands", which several meetings are

Time goes in the filters, never in the words. "In August" in q made it worse (61%, from 78%), since meaning has no calendar; started_after and started_before are applied before the search, so nothing outside the range is considered and nothing in it is crowded out.

It works least well on a bare code ("KV-1874") among many that look alike: ask what it was about.

• 200 The closest meetings, best first. None, when nothing shared is about it.
• 400 A parameter isn't what it should be; error says which.
• 401 No key or token, one that isn't Minne's, a key revoked or of an organisation that ended, or a sign-in ended or disconnected.
• 429 The key made 600 requests this minute. Wait the seconds Retry-After says.

{
  "results": [
    {
      "meeting": {
        "id": "mtg_01JBX5Q7M2A8N4R6T0V2W4Y6Z801M5JHFTFH01KXC4V2P9JNFB1",
        "title": "Atlas launch",
        "started_at": "2026-10-20T09:00:00Z",
        "shared_by": "Ada Lindqvist"
      },
      "score": 0.62,
      "passages": [
        {
          "title": "Launch date",
          "text": "Launch date\nSara Holm said the integration with Fortnox slips.\nOutcome: February.",
          "start": 840.0,
          "end": 1310.0
        }
      ]
    }
  ]
}

GET /v1/people

List one's people

A person's: the people in their own meetings, as they've named them in Minne, by name a page at a time: other names, role, company, which one is them, whether their voice is confirmed, and how many of their meetings each was in. A key can't.

• 200 Their people, by name.
• 400 A parameter isn't what it should be; error says which.
• 401 No key or token, one that isn't Minne's, a key revoked or of an organisation that ended, or a sign-in ended or disconnected.
• 403 Only a person's own app may do this, in their own meetings; an organisation's key reads.
• 429 The key made 600 requests this minute. Wait the seconds Retry-After says.

{
  "people": [
    {
      "person_id": "p_01JC2Q5Z8K3M7N9P1R4T6V8X0Y",
      "name": "Peter Larsson",
      "aliases": [
        "Peter"
      ],
      "role": "CEO",
      "company": "Acme",
      "is_me": false,
      "voice_confirmed": true,
      "meetings": 4
    }
  ]
}

PATCH /v1/people/{id}

Change one of one's people

A person's: one of their people, renamed, or with a role or company, as they'd change them in Minne. A new name keeps the old one among their other names, and every summary that names them reads the new one at once.

• 200 The person as they are now.
• 400 A parameter isn't what it should be; error says which.
• 401 No key or token, one that isn't Minne's, a key revoked or of an organisation that ended, or a sign-in ended or disconnected.
• 403 Only a person's own app may do this, in their own meetings; an organisation's key reads.
• 404 No meeting with this id is shared with the organisation now.
• 429 The key made 600 requests this minute. Wait the seconds Retry-After says.

{
  "error": "limit is a number from 1 to 100"
}

PUT /v1/meetings/{id}/speakers/{speaker}

Say who a speaker is

A person's, in their own meeting: who a speaker is, as they'd say it in Minne. One of their people (person_id), someone new (name, with role and company if known), nobody they know (unknown), or a voice that wasn't part of the meeting (background). It's their own word, as in Minne: the voice is saved, and Minne recognises it in their later meetings. Minne keeps it as said through the app, with its evidence.

• 200 The meeting's speakers as they are now, and how many still need naming.
• 400 A parameter isn't what it should be; error says which.
• 401 No key or token, one that isn't Minne's, a key revoked or of an organisation that ended, or a sign-in ended or disconnected.
• 403 Only a person's own app may do this, in their own meetings; an organisation's key reads.
• 404 No meeting with this id is shared with the organisation now.
• 409 The meeting changed while it was saving, or isn't ready.
• 429 The key made 600 requests this minute. Wait the seconds Retry-After says.

{
  "error": "limit is a number from 1 to 100"
}