docketbird_download_document
Download a court document by its DocketBird ID to read or save it locally. Use after searching for documents to retrieve the specific filing.
Instructions
Download a specific document by ID.
Returns the document content to **you** (the client) as an embedded resource
so you can read or save it — this works over the remote HTTP connection. In
local stdio mode, passing ``save_path`` instead writes the file to that folder
on your own machine (the server runs locally there).
When to use:
- User wants to retrieve a specific filing
- After searching for documents
- Downloading individual documents
Args:
document_id: DocketBird document ID
save_path: Local folder to save into. Only honored in local stdio mode,
where the server shares your filesystem. Ignored over a remote
HTTP connection (the file would land on the server, not your
machine), where the content is returned to you directly.
Returns:
- Remote, or local with no save_path: a list of content blocks — a text
summary plus an embedded resource holding the document bytes (base64),
capped at MAX_INLINE_SIZE. If the document exceeds that cap, returns a
text message with its direct download URL instead of inlining it.
- Local stdio with save_path: a text confirmation of the saved file path.
- On error / unavailable / restricted: a plain text message.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| save_path | No | ||
| document_id | Yes |