list_drafts
Drafts waiting for review in a workspace: research findings and agent uploads not yet confirmed, each with part, primitive, evidence quote, source, origin (research run, agent key, person, contribution) and its draft values; plus contributions from outside (with a trust score) that this key may decide on. 50 a page. Needs a key.
Parameters
- workspacestringrequired
Workspace slug
min 1 char - companystringoptional
Company slug; all companies when omitted
- originenumoptionalresearchagentpersoncontribution
- bystringoptional
run:<research run id>, key:<api key id> or person:<user id>
- confidenceenumoptionalverifiedself_reportedinferred_highinferred_low
- sinceenumoptional1d7d30d
- pagenumberoptional≥ 1≤ 10000
Example call
Agents call tools by name; you rarely write this by hand. It is here so you can test the server from a shell or your own code.
{
"name": "list_drafts",
"arguments": {
"workspace": "acme-builders",
"origin": "research"
}
}Response
The result is one text content block holding this JSON (abbreviated here). Errors come back with isError: true and a message such as Error 401: … or Invalid input: ….
{
"total": 1,
"items": [
{
"id": "c41a…",
"label": "Dispatch board"
}
]
}Over REST
The same call without MCP: GET/api/v1/workspaces/:slug/drafts