curl --request POST \
--url https://api.blinq.me/v1/notes/query \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "What did we decide about the launch?"
}
'{
"answer": "The launch moved to November [1] and the pricing page still needs sign-off [1, 2]. Reply to Dana once legal approves. [2]",
"citations": [
{
"id": "note-id-1",
"title": "Launch planning",
"share_url": "https://note.blinq.me/share-id-1"
},
{
"id": "note-id-2",
"title": "Call with Dana",
"share_url": "https://note.blinq.me/share-id-2"
}
]
}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.
curl --request POST \
--url https://api.blinq.me/v1/notes/query \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"query": "What did we decide about the launch?"
}
'{
"answer": "The launch moved to November [1] and the pricing page still needs sign-off [1, 2]. Reply to Dana once legal approves. [2]",
"citations": [
{
"id": "note-id-1",
"title": "Launch planning",
"share_url": "https://note.blinq.me/share-id-1"
},
{
"id": "note-id-2",
"title": "Call with Dana",
"share_url": "https://note.blinq.me/share-id-2"
}
]
}Authorizations
Send a Blinq API key as Authorization: Bearer <api-key>; enter only the key in the documentation playground.
Create and revoke keys in the Blinq web app under Settings > API keys.
The key needs the scopes required by the operation, and public API access requires a Pro or Business plan.
Body
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.
1Restricts 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.
1 - 8 elements1Response
The generated answer and its cited notes.
The generated answer and its cited notes.
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.
The unique source notes, in order of first appearance in the answer. Empty when the answer has no citations.
Show child attributes
Show child attributes