Skip to main content
Available as an add-on on paid plans.
Agents can capture files encountered during task execution: PDFs, documents, spreadsheets, images, and archives. 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. Retrieving an individual item gives you 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.

​
Extraction

Extraction parses supported files into structured JSON. Use extraction_schema to define exactly what you want back. Each storage item reports its extraction outcome in a result field (success or failure); a failed file has result set to failure but is still kept and available for download. See Supported files in the storage guide for the types that can be captured and extracted, and the file-size limit.

​
Deduplication

For recurring tasks, deduplication tells Deck to skip files that match one captured by a previous run. You choose which fields make a file “the same”. For a utility bill, that might be the account number plus the billing period start date. Files matching every chosen field against a prior capture are dropped, so you only ever process new documents. See the storage guide for configuration and field-picking guidance.

​
Input vs. output files

Storage items carry a purpose: attachment for files you provide as task input for the agent to use, extraction for files you provide as task input that Deck extracts data from directly (skipping the agent), and output for files the agent captures during a run. All three are returned together with a task run’s storage. File inputs are available on Enterprise plans. See providing files as input.

​
Retrieving files

Each item includes a pre-signed url for download and an extraction field with the structured data. URLs are time-limited; refetch the item if one expires. You can also retrieve a single 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.