curl https://rhizomeai.com/api/v3/conversations/3b1f8c6e-2a4d-4c1e-9f2a-7d5e6b8c9a01/documents/report_1 \
-H "x-api-key: YOUR_API_KEY"
import requests
conversation_id = "3b1f8c6e-2a4d-4c1e-9f2a-7d5e6b8c9a01"
headers = {"x-api-key": "YOUR_API_KEY"}
base = f"https://rhizomeai.com/api/v3/conversations/{conversation_id}"
conversation = requests.get(base, headers=headers).json()
for entry in conversation["documents"]:
document = requests.get(f"{base}/documents/{entry['id']}", headers=headers).json()
if document["type"] == "text":
print(document["content"])
else:
with open(document["filename"], "wb") as f:
f.write(requests.get(document["url"]).content)
{
"id": "report_1",
"title": "De Novo grants, 2026",
"type": "text",
"created_at": "2026-10-09T14:08:52.000Z",
"content": "# De Novo grants, 2026\n\nThe FDA granted 31 De Novo requests [1]. ..."
}
{
"id": "file_2",
"title": "De Novo grants, 2026",
"type": "file",
"created_at": "2026-10-09T14:09:30.000Z",
"url": "https://...digitaloceanspaces.com/v3_charts/...",
"filename": "De Novo grants, 2026.xlsx",
"expires_in": 300
}
Conversations
Get a document
A report, file or image the agent produced
GET
/
api
/
v3
/
conversations
/
{conversation_id}
/
documents
/
{document_id}
curl https://rhizomeai.com/api/v3/conversations/3b1f8c6e-2a4d-4c1e-9f2a-7d5e6b8c9a01/documents/report_1 \
-H "x-api-key: YOUR_API_KEY"
import requests
conversation_id = "3b1f8c6e-2a4d-4c1e-9f2a-7d5e6b8c9a01"
headers = {"x-api-key": "YOUR_API_KEY"}
base = f"https://rhizomeai.com/api/v3/conversations/{conversation_id}"
conversation = requests.get(base, headers=headers).json()
for entry in conversation["documents"]:
document = requests.get(f"{base}/documents/{entry['id']}", headers=headers).json()
if document["type"] == "text":
print(document["content"])
else:
with open(document["filename"], "wb") as f:
f.write(requests.get(document["url"]).content)
{
"id": "report_1",
"title": "De Novo grants, 2026",
"type": "text",
"created_at": "2026-10-09T14:08:52.000Z",
"content": "# De Novo grants, 2026\n\nThe FDA granted 31 De Novo requests [1]. ..."
}
{
"id": "file_2",
"title": "De Novo grants, 2026",
"type": "file",
"created_at": "2026-10-09T14:09:30.000Z",
"url": "https://...digitaloceanspaces.com/v3_charts/...",
"filename": "De Novo grants, 2026.xlsx",
"expires_in": 300
}
Returns one document from a conversation’s
Plus
documents. Text documents, such as reports, come back inline as markdown. Files (Word, Excel, PowerPoint) and images come back as a download URL that works for 5 minutes: fetch the document again for a new one.
Downloading Word, Excel and PowerPoint files needs a paid plan, as on rhizomeai.com.
Path parameters
string
required
The conversation’s id.
string
required
The
id of an entry in the conversation’s documents.Response
string
The document’s id.
string
The document’s title.
string
text, file or image.string | null
When the agent produced it, ISO 8601.
string
Only for
text: the document in markdown, with citation markers like [1]
that match the conversation’s citations.string
Only for
file and image: a download URL.string
Only for
file and image: the file name to save it as.integer
Only for
file and image: seconds until url stops working.Errors
| Status | Code | Description |
|---|---|---|
| 403 | forbidden | Downloading a Word, Excel or PowerPoint file needs a paid plan |
| 404 | not_found | No conversation or document with this id in your account |
401 and 429, see Errors.
curl https://rhizomeai.com/api/v3/conversations/3b1f8c6e-2a4d-4c1e-9f2a-7d5e6b8c9a01/documents/report_1 \
-H "x-api-key: YOUR_API_KEY"
import requests
conversation_id = "3b1f8c6e-2a4d-4c1e-9f2a-7d5e6b8c9a01"
headers = {"x-api-key": "YOUR_API_KEY"}
base = f"https://rhizomeai.com/api/v3/conversations/{conversation_id}"
conversation = requests.get(base, headers=headers).json()
for entry in conversation["documents"]:
document = requests.get(f"{base}/documents/{entry['id']}", headers=headers).json()
if document["type"] == "text":
print(document["content"])
else:
with open(document["filename"], "wb") as f:
f.write(requests.get(document["url"]).content)
{
"id": "report_1",
"title": "De Novo grants, 2026",
"type": "text",
"created_at": "2026-10-09T14:08:52.000Z",
"content": "# De Novo grants, 2026\n\nThe FDA granted 31 De Novo requests [1]. ..."
}
{
"id": "file_2",
"title": "De Novo grants, 2026",
"type": "file",
"created_at": "2026-10-09T14:09:30.000Z",
"url": "https://...digitaloceanspaces.com/v3_charts/...",
"filename": "De Novo grants, 2026.xlsx",
"expires_in": 300
}