Docsbook agent reply

POST/api/v1/docsbook_agent_reply

Features

Talk to the Docsbook agent about a job that is still open — answer a question it asked, add something it needs (a decision, a fact it could not find, a correction), or just ask it something about how the job is going ('how far is the API reference pass', 'did you find the auth docs'). You do not have to wait for it to ask first: send text any time the job is open and it picks the job back up with the whole exchange in front of it, replying in its next report — read docsbook_agent_status or docsbook_agent_activity after to see what it said.

Price — $0.00003 per call (twice what serving it costs us), charged to the workspace balance, the same as over MCP.

Also reachable by name at POST /api/v1/tools/docsbook_agent_reply.

Input2

Authorizationheaderrequired

Your API key, sent as Authorization: Bearer dbk_YOUR_API_KEY.Sent from your browser straight to the API — never to Docsbook, never stored.

task_idstring · body

The job to reply to.

textstring · body

What you want to tell the agent, in your own words.

Output3

okboolean

Whether the tool itself succeeded. A tool that ran and refused — an exhausted balance, a plan restriction, a bad argument — answers 200 with ok: false: the call was made and billed, and that refusal is its answer.

resultstring

The tool's own JSON answer, already parsed — not a string to parse a second time.

duration_msinteger

Server-side wall time for the call.

Limitations

Only for a job that is still open; a finished one is finished, start a new one with docsbook_agent.

Responses

200The tool ran. Read ok to see whether it succeeded.

401Missing or invalid API key.

Example input

curl -X POST 'https://docsbook.io/api/v1/docsbook_agent_reply' \
  -H 'Authorization: Bearer dbk_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{}'

Example output

{
  "ok": true,
  "result": "<result>",
  "duration_ms": 0
}

更新日 Sep 24, 2026