Skip to main content
Available on Enterprise plans.
Agents can capture files encountered during task execution: documents, images, videos, PDFs, spreadsheets, reports. Enable storage on a task, and Deck captures the files the agent is instructed to collect and makes them available through the API. Turn on extraction, and Deck also parses supported files into structured JSON.

​
How storage fits in

Storage is configured on a task. When a task run executes with storage enabled, captured files become storage items tied to that run. Each item includes a signed download URL and, if extraction is on, structured data pulled from the file.

​
Enabling storage

Storage can be enabled on a task from the Console or the API.
FieldsWhat it does
enabledCapture files produced during execution
extractionParse captured files into structured JSON
extraction_schemaJSON Schema that controls what fields are extracted
deduplicationSkip files already captured from previous runs for the same task and credential

​
Extraction

Extraction works with PDFs, invoices, receipts, statements, and common document types. Use extraction_schema to define exactly what you want back. If extraction fails on a specific file, the raw file is still available for download.

​
Deduplication

When enabled, Deck compares files against previous runs for the same task and credential using file hashes. Duplicates are skipped. This is useful for recurring tasks like daily statement fetches where you only want new documents.

​
Retrieving files

GET /v2/task-runs/{run_id}/storage
Each item includes metadata and an extraction field with the structured data. To get a signed download URL, retrieve the individual storage item by ID with GET /v2/storage/{storage_id}.

​
Retention

Retention period varies by plan. All files are deleted after 90 days.

​
Deep dives

Storage & document extraction

Full integration walkthrough with extraction schemas and examples.