Skip to main content
Available on Enterprise plans.
Agents can capture any file 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

Configure storage when you create or update a task.
{
  "storage": {
    "enabled": true,
    "extraction": true,
    "deduplication": true
  }
}
FieldWhat 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 connection

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 connection 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 a signed url for downloading the raw file and an extraction field with the structured data.

Retention

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

Deep dives