Notes

Ask a question about notes

Generates an answer to a question using the authenticated user's note titles and note bodies (AI summaries for recordings, saved text for typed notes). Transcripts are not used, and each note body is truncated to 8,000 UTF-16 code units.

Pass between 1 and 8 of your own note_ids to answer from specific notes, or omit the field to let the API select up to 10 of the most relevant notes automatically.

The answer contains inline markers such as [1] or [1, 2]: one-based positions in citations, where each unique note is numbered in order of first appearance and repeat references reuse the same number.

When no accessible notes match, the answer is No accessible notes were available to answer this question. If an answer cannot be generated, the request fails with 503 and the message Blinq could not generate an answer. Try again later.

Requires the blinq:notes:read scope.

post/v1/notes/query

Request

  • Base URL
    https://api.blinq.me
  • Auth
    HTTP bearer

Request body

querystring required

A natural-language question. Answers draw on note titles and note bodies (the AI summary for a recording or the saved text of a typed note), not transcripts. Each note body is truncated to 8,000 UTF-16 code units.

note_idsstring[]

Restricts the answer to between 1 and 8 notes you own. Omit to let the API select up to 10 of the most relevant notes automatically. IDs of inaccessible notes are ignored.

Response

The generated answer and its cited notes.

answerstring required

The generated answer. Inline markers such as [1] or [1, 2] are one-based positions in citations. Each unique note is numbered in order of first appearance, and repeat references reuse the same number. When no accessible notes match, the answer is No accessible notes were available to answer this question.

Changes

No recorded changes to this operation across all 1 revision of this API.