POST/api/v1/search/ask

Ask AI about your items

Answers a question from the items you can open, with Claude Haiku 5.5: AI turns the question into search terms, search finds up to 40 matching items, and AI picks the relevant ones and writes a short answer that cites them as [n]. Only text you can open is sent, never an encrypted item. Streams server-sent events: status (the stage), results (the matching items), delta (answer text as it's written), then done with answer, citations and ranked; or limit when an AI limit stops it, or error. Counts towards your AI limits.

API token required30 per minute per IPMCP: ask_documents

Guide: Ask AI

Code samples and Try it

Request body

application/json, required

questionstringRequired
1–500 characters.
scopestring
Up to 40 characters.
currentstring
Up to 40 characters.

Responses

200OK.
401No token, or the token is revoked or mistyped.
422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).
429Too many requests from your IP address. Wait the seconds in Retry-After.

const res = await fetch("https://api.markdrop.in/api/v1/search/ask", { method: "POST", headers: { Authorization: `Bearer ${process.env.MARKDROP_TOKEN}`, "Content-Type": "application/json", }, body: JSON.stringify({ "question": "How do we onboard contractors?" }), }); const data = await res.text();

import os import requests r = requests.post( "https://api.markdrop.in/api/v1/search/ask", headers={"Authorization": f"Bearer {os.environ['MARKDROP_TOKEN']}"}, json={"question": "How do we onboard contractors?"}, ) r.raise_for_status() print(r.text)