Skip to content
Dynamite Docs logoDynamite Docs
The handoff
Workspace manual: The working manualChoose a document and model. Review fields beside the source. Export accepted data. Illustrative example, not extracted customer data.FROM SOURCE FILE TO A RESULT YOU CAN USEWorkspacemanualReview workspaceThe workingmanual1Choose a documentand model2Review fieldsbeside the source3Export accepteddata
  1. 01Choose a document and model
  2. 02Review fields beside the source
  3. 03Export accepted data
Learn one step, then try your document. Illustrative example.

Dynamite Docs reads supported PDFs, scans, images, and business files, proposes fields and table rows, and keeps the source beside the result for review. Correct the values, then export to Excel, CSV, JSON, Google Sheets, or a connected workflow.

Last updated:

How it works, in three steps

$ cat invoice.pdf | dynamitedocs infer | dynamitedocs correct | dynamitedocs remember > data.csv

inferAI reads the layout & schema
correctyou review the table
remembercorrections become patterns
Learn to extract, review, and export document data with AI: reviewable document extractionReview the source document and extracted rows in one workspace.
Learn to extract, review, and export document data with AI: human-in-the-loop validationResolve flagged values before approving the extraction.
Learn to extract, review, and export document data with AI: Excel, CSV and JSON exportDownload reviewed data as CSV, Excel, or JSON.
Learn to extract, review, and export document data with AI: Google Sheets exportPush reviewed rows into a new or existing Google spreadsheet.

01

Start extracting document data with AI using Dynamite Docs

Your first document, from zero to structured data

Dynamite Docs turns business documents such as invoices, receipts, contracts, statements, and forms into structured, editable tables. There is no template setup and no training: you upload a document, the AI infers the fields, and you correct anything it missed. It saves those corrections as patterns that can be reused for a similar layout.

A document open beside extracted table rows in Dynamite DocsClick to enlarge
Figure 1.1: Source document and extracted rows in the review workspace.

Prerequisites

  • A supported document file (PDF, PNG, JPG, TIFF, WEBP, DOCX, XLSX, or EML) under 50 MB.
  • A desktop or mobile browser with JavaScript enabled (Chrome, Edge, Firefox, Safari).
  • Internet connection for hosted AI models (or active local Ollama companion for local inference).
  • Free account sign-in to save layout patterns and download CSV, JSON, or XLSX exports.
1

Sign in to your account

Click the [Sign In] button in the top navigation bar to authenticate with Clerk, or start immediately as an anonymous guest. Signed-in users receive higher processing limits and persistent cloud storage on paid tiers.

2

Upload your document

Click the [Upload] button in the Library sidebar or press Ctrl+U (⌘+U on macOS). You can also drag and drop your document file directly into the left sidebar file list.

3

Run schema inference and extraction

Select the uploaded document from the Library sidebar, then click the [Extract] button in the Data Studio toolbar or press Ctrl+Enter. The AI reads the page and populates the structured table below.

4

Review and correct values inline

Verify extracted numbers and text against the source document. Double-click any cell to edit mistaken text or amounts directly. Click the [Save] button or press Ctrl+S to commit changes and store the layout pattern.

5

Export verified structured data

Click the [Export] button in the Data Studio toolbar or press Ctrl+Shift+S, then select [Download CSV], [Download XLSX], or [Download JSON].

Exact error messages & resolutions

Document exceeds plan limit of 5 pages

Split multi-page PDFs to 5 pages or fewer, or upgrade to Starter (up to 50 pages) or Pro (up to 500 pages).

413 Payload Too Large (50 MB limit)

The uploaded file exceeds the 50 MB server boundary. Downsample high-DPI image scans or compress the PDF.

Monthly processing limit reached (0 PE remaining)

All page-equivalents for the current billing cycle have been spent. Processing resumes at monthly reset or upon upgrading your plan.

Troubleshooting this task

Table returned empty or missing lines: Check if your PDF is an encrypted or password-protected file. For physical paper scans, confirm the document is oriented upright and scanned at 150 DPI or higher.

Wrong columns inferred: Double-click column headers in Data Studio to rename fields or click [Add column]. Once saved with [Save], the layout memory will remember your structure for future files.

Tip: press ? anywhere in the app to see the most common shortcuts at a glance.

Related workflows & guides

Next chapterUploading documents

02

Upload PDFs, images, and documents for AI extraction

What you can upload, and where your files live

Supported formats

  • Extraction pipeline: PDF, PNG, JPG/JPEG, WEBP, TIFF, AVIF, DOCX/DOC, XLSX/XLS, PPTX/PPT, and raw email files (.eml)
  • Document library: PDF, PNG, JPG/JPEG, WEBP, TIFF, and AVIF
  • Each successfully processed hosted page costs one PE

Where files are stored

  • Free: browser-only storage (blob URLs, no server storage)
  • Starter: 500 MB encrypted cloud storage
  • Pro: 2 GB encrypted cloud storage, synced across devices
  • Scale: 10 GB encrypted cloud storage, synced across devices
  • If cloud storage is exceeded, uploads fall back to browser-only
Integrated PDF ViewerClick to enlarge
Figure 2.1: Integrated PDF & Image Document Viewer rendering crisp page layouts.

Prerequisites

  • Source document in supported format under the 50 MB per-file size boundary.
  • Sufficient cloud storage space (or proceed in browser-only mode on Free).
  • For batch jobs: Starter plan or above (Starter allows 25 files/job; Pro allows 200; Scale allows 500).
  • For email intake: Pro or Scale plan with verified email forwarding enabled.
1

Upload individual files

Click the [Upload] button in the Library sidebar or press Ctrl+U. You can also drag and drop files from your desktop directly into the document list.

2

Create a batch Extraction job

Select multiple documents in the Library by holding Shift or pressing Ctrl+A, then click the [Add to job] button in the action toolbar.

3

Name and launch the extraction job

In the job configuration panel, enter a descriptive title for the batch and click [Run job]. Tasks run durably in the background with automatic retries on failure.

4

Capture attachments via email forwarding (Pro & Scale)

Click the [Email capture] button in the header bar. Copy your private, unguessable forwarding address, or forward documents directly to capture@dynamitedocs.com from your verified account email address.

Exact error messages & resolutions

413 Payload Too Large (50 MB limit)

The upload exceeds the 50 MB server limit. Compress images or split the document into separate files.

Cloud storage limit reached (falling back to browser-only)

Your account has exhausted its cloud allowance (Starter: 500 MB, Pro: 2 GB, Scale: 10 GB). Delete old files from the Library or upgrade your storage allowance.

Batch job exceeds file limit of 25 files

Starter is limited to 25 files per job. Reduce the selection or upgrade to Pro (200 files) or Scale (500 files).

Troubleshooting this task

Files disappeared after closing browser: On the Free plan, files are stored strictly in local browser memory (blob URLs). Clearing cookies, switching browsers, or incognito mode removes them. Upgrade to Starter or higher for persistent Cloudflare R2 storage.

Email capture attachment didn’t arrive: Confirm that you forwarded to your private alias or capture@dynamitedocs.com from your account email, that the attachment format is supported, the total email size is below 25 MB, and your sender address is permitted.

Heads up: on the Free plan your files live in the browser. They survive a refresh, but clearing site data, switching browsers, or using incognito will remove them. Upgrade to Starter or above for durable cloud storage.
Document workflows: see these formats in action: invoice data entry, receipt processing, and accounts payable automation.

Related workflows & guides

Next chapterExtracting data

03

Run document extractions using AI and review the results

How the infer → correct → remember loop works

Extraction is where Dynamite Docs earns its keep. It operates on the core loop of infer → correct → remember:

1

Infer

The AI reads the document, recognizes the layout, and infers a schema that identifies which columns matter and what each value is.

2

Correct

You review the table in the Data Studio and edit anything that is wrong. You can also add or remove columns to match your needs.

3

Remember

Every correction is saved as a reusable pattern. The next document with the same layout is extracted more accurately, with less review time.

Prerequisites

  • At least one document uploaded and visible in the Library sidebar.
  • Available Page-Equivalents (PE) in your monthly balance (1 PE per processed page) or a connected BYOK key.
  • Document page count within tier limit (Free: 5 pages; Starter: 50 pages; Pro: 500 pages; Scale: 1,000 pages).

Steps to run extraction:

1

Select document and configure routing

Click on the target document in the Library sidebar to open it in the document viewer. Check [AI Settings] in the top header to confirm your active model routing (Standard, Premium, or BYOK).

2

Execute extraction

Click the [Extract] button in the Data Studio toolbar or press Ctrl+Enter. The AI reads the page and populates the structured table below.

3

Run batch jobs for multiple documents

To extract several files at once, select them in the Library, click [Add to job] in the action toolbar, assign a job title, and click [Run job]. Results land in the [View Extractions] panel under the job folder.

Cost of extraction

Each successfully processed hosted page costs 1 page-equivalent (PE). Free and Starter BYOK pages use the same allowance. Failed extractions and Pro or Scale BYOK runs cost 0 PE.

Document size cap

Each plan allows a maximum number of pages per document (see Plans & limits). Documents over the cap must be split first.

Exact error messages & resolutions

Document exceeds plan limit of [X] pages

The document has more pages than allowed for a single extraction. Split the PDF into smaller page ranges or upgrade plan.

Monthly processing limit reached (0 PE remaining)

Your monthly hosted PE allowance is spent. Connect your own provider key (BYOK is unlimited on Pro and Scale) or upgrade your plan.

Extraction timed out (120s limit)

Dense multi-page scan took longer than the server lease timeout. Split the file or switch to a faster vision model in AI Settings.

Troubleshooting this task

Low confidence warning tags: Cells with low confidence flags show amber badges. Zoom in on the PDF viewer to verify values directly, correct them inline, and save the pattern.

Complex multi-table invoices: When an invoice contains multiple tables (e.g. services and reimbursable expenses), use [Add column] in Data Studio to shape the schema to capture both, or extract in separate sections.

Related workflows & guides

Next chapterData Studio

04

Review and correct AI-extracted tables beside the source

Review, edit, save, and export your tables

The Data Studio panel sits at the bottom of the app. It shows the active extraction as an editable table, the same shape as a spreadsheet but built specifically for documents.

Data Studio Inline Table EditorClick to enlarge
Figure 3.1: Data Studio Panel showing inline field editing, confidence ratings, and schema controls.

Prerequisites

  • A completed extraction open in the workspace.
  • Source document rendered in the upper viewer pane for side-by-side verification.
1

Compare extracted cells with the source document

The split-pane layout displays the original PDF or image on top and the editable table below. Click any cell to cross-reference with the highlighted region in the document.

2

Edit values and resolve confidence flags

Cells flagged with low confidence display amber warning tags. Double-click the cell to type corrections directly. Edits save to memory immediately.

3

Shape columns and schema

Click the [Add column] button in the Data Studio toolbar to introduce missing fields, or right-click any column header to rename, reorder, or delete columns.

4

Save corrections and register layout pattern

Click the [Save] button or press Ctrl+S. Your changes are saved to the extraction record and stored as a reusable pattern for documents with this layout.

5

Adjust panel layout

Use the [Collapse] or [Expand] toggle buttons in the Data Studio header bar to give more vertical space to the document viewer or the table.

Exact error messages & resolutions

Validation failed: Invalid numeric value

A cell formatted as currency or integer contains letters or invalid characters. Correct the entry and re-save.

Save failed: Unnamed column header

Every column must have a non-empty name before schema saving. Enter a header label and click Save.

Troubleshooting this task

Edits not appearing in download: Ensure you press Ctrl+S or click [Save] before opening the export menu. Downloads pull from the committed table state.

Accidentally deleted a column: Click [Add column] to recreate the header, or re-select the document in the sidebar to discard unsaved edits.

Tip: saved corrections become reusable patterns for similar document layouts. Keep reviewing uncertain values because a pattern does not prove that a new document is correct.

Related workflows & guides

Next chapterExporting & sharing

05

Export reviewed AI extractions to Excel, CSV, and JSON

CSV, JSON, clipboard, and imports

Every extraction can be pulled out of the app in the format you actually use. Exporting never changes the table. It only creates a copy of the current state.

Managing Completed ExtractionsClick to enlarge
Figure 4.1: Extractions Workspace Manager displaying batch results and export actions.

Prerequisites

  • Extracted and reviewed table open in Data Studio.
  • Free accounts: CSV, JSON, and XLSX downloads included after free signup.
  • Starter, Pro, and Scale: Word (.docx), PDF export, Google Sheets push, and Google Drive export included.
  • Google integrations: Connected Google account with per-file drive.file authorization.

Export the active table

  • CSV opens in Excel, Sheets, Numbers, and most tools
  • Free accounts can export CSV, JSON, and XLSX after signup
  • Starter and above can also export Word and PDF

Import data back in

Paste a CSV into the extractions panel to create a table without a document. It is great for combining data from other systems.

1

Open the export menu

In the Data Studio header, click the [Export] dropdown menu or press Ctrl+Shift+S.

2

Download file to your computer

Select [Download CSV], [Download XLSX], or [Download JSON]. The file generates with preserved column types and saves immediately to your Downloads folder.

3

Push to Google Sheets (Starter and above)

Click [Push to Google Sheets]. A new tab is created in your last-used spreadsheet with the extracted rows, accompanied by a “Document Fields” tab for metadata.

4

Save to Google Drive (Starter and above)

Click [Save to Google Drive] to export an XLSX, CSV, or JSON directly into your Google Drive folder.

5

Copy table as CSV to clipboard

Click the [Copy CSV] button in the extractions sidebar to grab the entire structured table as comma-separated values for direct pasting into any spreadsheet.

Exact error messages & resolutions

Google Sheets push failed: 401 Unauthorized

Google OAuth session has expired. Click [Integrations] in the header and reconnect Google Sheets.

Export format requires Starter plan

Word (.docx) and PDF export require Starter, Pro, or Scale. Choose CSV, JSON, or XLSX on Free, or upgrade your plan.

Troubleshooting this task

Characters corrupted in Excel: Dynamite Docs exports CSV with an automated UTF-8 Byte Order Mark (BOM) so international currencies and accented letters render accurately in Microsoft Excel.

Leading zeroes truncated: If your invoice numbers (e.g. 00482) lose their leading zeroes in Excel, export as XLSX rather than raw CSV.

Formatting is preserved: column order, edited values, and added columns all carry into the export exactly as you left them.

Related workflows & guides

Next chapterAPI & webhooks

06

Automate AI document extraction with APIs and webhooks

Pull structured data into your own stack

Every extraction can be pulled into your own stack. Dynamite Docs exposes a REST API for exporting structured data, outbound webhooks that fire when an extraction completes, and a Google Sheets push so non-technical teammates can stay in the spreadsheet. Together they make Dynamite Docs an infrastructure layer with no lock-in. Bring your own AI keys, or use ours.

Prerequisites

  • Starter, Pro, or Scale plan (REST API keys and outbound webhooks enabled).
  • Public HTTPS endpoint with SSL/TLS certificate for receiving webhook payloads (10-second response timeout).
  • Valid session token or workspace account to mint API tokens.
1

Generate an API token

Open the [Webhooks & API] dialog from the workspace header. Click [Generate Key], assign a label (e.g. backend-pipeline), and copy the key (dd_live_...).

2

Register an outbound webhook endpoint

In the Webhooks section, click [Add Webhook Endpoint], paste your public HTTPS destination, and copy the secret HMAC key.

3

Trigger inference or export via API

Use POST /api/v1/infer to upload documents for extraction, or query GET /api/v1/extractions/:id/export using the Authorization: Bearer <key> header.

4

Verify webhook signatures

Validate incoming deliveries by computing HMAC-SHA256(secret, rawBody) and comparing against the X-Dynamite-Signature header.

Public API & API keys through Dynamite Docs

The public API lives under /api/v1 and is authenticated with a scoped API key sent in either the Authorization: Bearer header or the X-API-Key header. Mint and manage keys anytime directly from the Webhooks & API panel in the workspace header. Scoped keys can list and export extractions, check usage, and submit documents for inference. File, settings, account, and billing changes still require your workspace session.

Create an API key via session or the workspace UI (/app?modal=webhooks)

curl -X POST -H "Authorization: Bearer <session-token>" \
  -H "Content-Type: application/json" \
  -d '{"name":"ci-pipeline"}' \
  https://app.dynamitedocs.com/api/tokens
  • Keys look like dd_live_<64 hex>; only their SHA-256 hash is stored, so a leaked database never exposes a working key.
  • Manage them with GET /api/tokens (list) and DELETE /api/tokens/:id (revoke) using your session token, or visually in the Webhooks & API modal.

1. Export an extraction (GET /api/v1/extractions/:id/export)

Request (Authorization: Bearer or X-API-Key)

# Standard Bearer authorization:
curl -H "Authorization: Bearer dd_live_<your-key>" \
  "https://app.dynamitedocs.com/api/v1/extractions/<id>/export?format=json"

# Or using the custom X-API-Key header:
curl -H "X-API-Key: dd_live_<your-key>" \
  "https://app.dynamitedocs.com/api/v1/extractions/<id>/export?format=csv"

Response (200 OK — application/json)

{
  "id": "ext_01j5x9b3",
  "fileId": "file_8829f0",
  "fileName": "vendor_invoice_1092.pdf",
  "docType": "Invoice",
  "label": "August Operations",
  "folderId": "fld_01h8q2",
  "isVirtual": false,
  "columns": ["Invoice Number", "Date", "Vendor", "Line Total", "Tax", "Amount Due"],
  "rows": [
    ["INV-1092", "2026-08-01", "Acme Industrial Ltd", "$1,250.00", "$100.00", "$1,350.00"]
  ],
  "metadata": {
    "vendor": "Acme Industrial Ltd",
    "invoice_number": "INV-1092",
    "total": "1350.00",
    "currency": "USD"
  },
  "confidence": 0.98,
  "fieldConfidence": { "Invoice Number": 0.99, "Amount Due": 0.98 },
  "summary": "Vendor invoice from Acme Industrial Ltd for precision CNC milling totaling $1,350.00.",
  "createdAt": "2026-08-15T09:12:00.000Z",
  "updatedAt": "2026-08-15T09:12:00.000Z"
}

2. Infer directly from a document (POST /api/v1/infer)

Request (multipart/form-data upload)

curl -X POST \
  -H "Authorization: Bearer dd_live_<your-key>" \
  -F "file=@invoice.pdf" \
  https://app.dynamitedocs.com/api/v1/infer

Response (200 OK — application/json)

{
  "id": "ext_99a8b7",
  "fileId": "file_77c2d1",
  "fileName": "invoice.pdf",
  "docType": "Invoice",
  "columns": ["Invoice #", "Vendor", "Due Date", "Total"],
  "rows": [
    ["INV-4410", "Apex Logistics", "2026-08-30", "$3,420.00"]
  ],
  "metadata": {
    "vendor": "Apex Logistics",
    "total": "3420.00",
    "currency": "USD"
  },
  "confidence": 0.97,
  "createdAt": "2026-08-22T14:10:00.000Z"
}

3. List extractions & check monthly usage

List extractions (paginated, filtered, sorted)

curl -H "Authorization: Bearer dd_live_<your-key>" \
  "https://app.dynamitedocs.com/api/v1/extractions?page=1&limit=20&sort=created_at&order=desc"

Check monthly API usage (GET /api/v1/usage — does not count against quota)

curl -H "Authorization: Bearer dd_live_<your-key>" \
  https://app.dynamitedocs.com/api/v1/usage

# Response:
{
  "usage": {
    "month": "2026-08",
    "calls": 42,
    "limit": 3500,
    "remaining": 3458,
    "unlimited": false
  }
}
  • Query params: page (default 1), limit (1–100, default 20), sort (created_at | updated_at | label | doc_type), order (asc | desc), doc_type (exact filter). Responses carry a pagination object with total, totalPages, and hasMore.
  • Formats: csv (default, with BOM for Excel), json, and xlsx.
  • Inference: POST /api/v1/infer uploads a document (multipart/file) and runs the same extraction engine as the app, returning the structured table in the response. It counts as one API call plus the document’s pages against your monthly processing budget; extractions persist and trigger webhooks for the key’s owner.
  • Status codes: 200 ok, 401 missing/invalid key, 404 not found, 429 rate limit or monthly quota exceeded. Errors are JSON with a stable code.
  • Limits: rate-limited per key (default 60/min) and metered against your monthly API-call allowance. Check it with GET /api/v1/usage (usage checks don’t count toward your allowance). Revoking a key takes effect on the very next request.

Webhooks

Outbound webhooks notify your endpoint when an extraction completes. No polling needed. Set them up from the Webhooks button in the app header. Up to 5 endpoints per account; only public HTTPS URLs are accepted.

  • Event: extraction.completed fires after every successful extraction, queue or standalone.
  • Signature: each POST carries an HMAC-SHA256 signature in the X-Dynamite-Signature header, computed over the raw body with your webhook secret. Verify it before trusting the payload.
  • Reliability: deliveries retry with exponential backoff and jitter on network errors, 429s, and 5xx (up to 3 attempts), with a 10-second timeout. Delivery status is visible in the app.

extraction.completed payload

{
  "event": "extraction.completed",
  "timestamp": "2026-08-13T12:00:00.000Z",
  "data": {
    "extractionId": "…",
    "fileId": "…",
    "docType": "Invoice",
    "columns": ["Invoice #", "Date", "Total"],
    "rows": [[…]],
    "metadata": {…},
    "confidence": 0.97
  }
}
Verify the signature: HMAC-SHA256(secret, rawBody).toString('hex') must equal X-Dynamite-Signature. Use the raw request body, not a re-stringified object.

Google Sheets push

Connect Google Sheets once from the app header, then push any extraction with one click from the Data Studio export menu. Each push lands on a fresh tab named after the document type, and a separate “Document Fields” tab carries the metadata. Pushes reuse your last-used spreadsheet and never overwrite earlier tabs.

Google Drive import & export

The Google Picker integration lets you select importable files from your Google Drive with multi-file selection, then streams only the files you choose into the normal upload pipeline. Completed extractions can be saved back to Drive as XLSX, CSV, or JSON files from the Data Studio export menu.

Google OAuth scopes: Google Drive import, Drive export, and Sheets push all use the non-sensitive, per-file drive.file permission. The Google Picker API securely lets you select specific files from your Drive without granting broad Drive read access.

Exact error messages & resolutions

401 Unauthorized: Invalid or missing API key

The provided token is malformed or revoked. Check the Authorization: Bearer header and generate a new key if needed.

429 Too Many Requests (Rate limit or monthly quota exceeded)

Rate limit is 60 requests per minute per key. Check usage statistics via GET /api/v1/usage or upgrade your plan allowance.

400 Bad Request: Only public HTTPS URLs are accepted for webhooks

Webhook endpoints must use HTTPS with a valid certificate. Localhost and raw IP addresses are rejected by SSRF filters.

Troubleshooting this task

Webhook signature mismatch: Compute the HMAC-SHA256 signature on the raw request body bytes before your web framework parses the body as JSON.

Retries triggering unexpectedly: Your endpoint must respond with a 2xx HTTP status code within 10 seconds. Return 200 immediately and process payloads in an asynchronous worker queue.

Developers: for the complete reference, including tokens, curl examples, payloads, and integration patterns, see the REST API integration guide.

Related workflows & guides

Next chapterFolders & labels

07

Organize document batches, tag records, and filter extraction history

Keep your documents organized

Folders group your documents and extractions into a navigable tree, and labels add an extra layer of categorization on top. Use them together to keep even large libraries structured and accessible.

Prerequisites

  • At least one document or extraction present in the Library sidebar.
  • Signed-in account to retain folder hierarchies and label assignments across browser sessions.
1

Create a new folder

Click the [New folder] icon in the Library sidebar or press Ctrl+Shift+N. Type a descriptive name (e.g. “Q3 Supplier Invoices”) and press Enter.

2

Move documents into folders

Drag files from the Library list directly into the destination folder, or select multiple documents with Ctrl+click and choose [Move to folder] from the action bar.

3

Assign color-coded labels

Right-click any document in the sidebar, select [Add label], and choose a tag (e.g. “Reviewed”, “Pending”, or “Audit Ready”).

4

Launch batch extractions from a folder

Right-click any folder containing unextracted files and select [Run extraction job on folder] to create and trigger a batch Extraction job in one click.

5

Search and filter files

Press Ctrl+F or click the search box in the sidebar to filter documents instantly by file name, label, or folder path.

Exact error messages & resolutions

Folder name already exists

A folder with this name already exists in the selected directory. Choose a unique name.

Cannot delete folder with active files

Move or delete the files contained in the folder before deleting the directory.

Troubleshooting this task

Search not returning cell data: Sidebar search queries document names and label metadata. To search within extracted table cells, use the search filter inside the Data Studio header.

Folder chevron collapsed: If files seem hidden, click the triangle toggle icon next to the folder name to expand its contents.

Related workflows & guides

Next chapterAI providers & keys

08

Configure document extraction with your own LLM API keys

Hosted models, or bring your own key (BYOK)

Dynamite Docs ships with seven hosted AI providers: Mistral, Gemini, OpenAI, Anthropic, Groq, OpenRouter, and Cloudflare. Extraction is routed to the best available provider automatically, so there is nothing to configure to get started.

AI Configuration Panel & Models ListClick to enlarge
Figure 5.1: AI Configuration Panel showing available vision models, BYOK key setup, and custom endpoints.

Prerequisites

  • An active API key from your chosen provider (Gemini, OpenAI, Anthropic, Mistral, Groq, OpenRouter, or custom endpoint).
  • BYOK is available on every plan (Free and Starter share the monthly PE quota; Pro and Scale are unlimited).
  • For local Ollama companion: Starter, Pro, or Scale plan, Ollama installed on 127.0.0.1:11434 with a vision model, and the Windows companion running on port 8756.

Hosted premium

The Starter, Pro, and Scale plans include the premium hosted models, which are more accurate on complex documents. Free uses the hosted standard models.

Bring your own key

BYOK is available on every plan. Connect any supported provider or OpenAI-compatible endpoint. Free and Starter runs use monthly PE; Pro and Scale runs are unlimited.

1

Open AI Settings

Click the [AI Settings] button in the workspace top navigation bar.

2

Connect provider API key

Select your provider from the dropdown, paste your secret key into the [API Key] field, and click [Test & Save Key]. Keys are encrypted at rest with AES-256-GCM and never exposed to the client.

3

Select default extraction model

Choose your preferred vision model from the model list (e.g., gpt-4o, claude-3-5-sonnet, mistral-large). All future extractions will route to your connected key.

4

Set up Local Ollama companion (optional)

For sensitive files requiring local model execution, launch the companion app, then switch the routing dropdown in [AI Settings] to [Local Ollama]. Confirm the status turns green.

Exact error messages & resolutions

401 Unauthorized / Invalid API Key

The provider rejected the key. Check for missing characters, spaces, or an inactive billing account on your provider dashboard.

Failed to connect to local companion on 127.0.0.1:8756

The Windows companion service is stopped. Launch Dynamite Docs Companion from the Windows Start menu.

Ollama model not found: llama3.2-vision

The configured vision model is missing in Ollama. Run ollama pull llama3.2-vision in your terminal.

Troubleshooting this task

Provider rate limit exceeded (429): Your connected key reached its rate limit with the AI provider. Check your usage tiers in OpenAI/Anthropic/Google consoles.

Local inference slow: Verify hardware acceleration in Ollama (Nvidia CUDA or Apple Metal). Quantized models like llama3.2-vision:11b-instruct-q4_K_M provide the best balance of speed and accuracy.

Privacy: your keys are encrypted with AES-256-GCM and used only to route your own extraction requests. They are never shared and never used for anything else.
Pricing: BYOK provider models are available on every plan. Own-key processing is unlimited on Pro and Scale. See the pricing page for what each plan includes.

Local Ollama companion (on-device model inference)

For documents that cannot leave your workstation due to client confidentiality, HIPAA, or strict internal data residency rules, Dynamite Docs supports local model extraction through Ollama. The Dynamite Docs Windows companion connects your web workspace to the local extraction service on loopback port 8756. Local model requests go to Ollama at port 11434 without calling a hosted AI provider. Local model inference runs on your computer; account, token, and workspace features remain hosted. Choose browser-only file storage when the source should stay on your computer.

Keep the companion and Ollama running while you extract documents. Sign in, import files, review results, and export from your browser workspace. The workspace and account services require internet access.

  • Available on Starter, Pro, and Scale plans.
  • Requires Ollama installed on your machine with a multimodal vision model like llama3.2-vision or minicpm-v.
  • Read the comprehensive Local Document AI guide for full hardware recommendations, quantization choices, and runtime benchmarks.
  • Get Dynamite Docs from Microsoft Store

Related workflows & guides

Next chapterSecurity & privacy

09

Understand security and data residency for AI extraction

Encryption, provider isolation, and training controls

Choose storage and model processing separately. Review the selected provider and your active routing rules before processing sensitive documents.

Encryption

  • All traffic is encrypted in transit (TLS)
  • Stored documents and tables are encrypted at rest
  • API keys are encrypted with AES-256-GCM before storage

Training and provider terms

  • Dynamite Docs does not use customer documents to train foundation models. Hosted and own-key requests are also subject to the selected provider's handling terms. Check the provider and routing policy before processing sensitive documents.
  • Local Ollama inference runs on your computer; account and workspace features remain hosted.
  • Provider keys never leave the server and are never sent to the browser

For stricter needs, AI Settings exposes routing rules that lock extraction to the providers you trust:

  • Sensitive Documents mode: only use models that do not train on your data. Gemini's free tier is excluded by default.
  • No-training only: block any model that may retain or train on submitted content (Gemini, OpenRouter).
  • Free models only: spend only your connected free keys, never host or paid quota.
  • Local only: route every extraction through the Windows companion (127.0.0.1:8756) to Ollama instead of an external AI provider. See our Local Document AI guide for setup details.
BYOK = data sovereignty: connecting your own provider means your data never touches a model you did not choose. You pick the provider, you pay the provider directly.

Related workflows & guides

Next chapterPlans & limits

10

Understand AI extraction plans and processing limits

What each plan includes

The table shows each family’s entry package. Starter offers 100 or 500 PE, Pro offers 1,000 or 2,000 PE, and Scale offers 5,000 PE per month. Compare all subscription packages.

FeatureTry free for 28 DaysStarterProScale
USD price$0$13/mo · $130/12 months$59/mo · $590/12 months$259/mo · $2590/12 months
INR price₹0₹259/mo · ₹2,590/12 months₹1,299/mo · ₹12,990/12 months₹5,199/mo · ₹51,990/12 months
Page-equivalents / month251001,0005,000
Pages per document5505001,000
Documents per day5UnlimitedUnlimitedUnlimited
StorageBrowser-local files500 MB cloud storage2 GB cloud storage10 GB cloud storage
Durable jobs—25 files/job · 10 active · unlimited runs200 files/job · 25 active · unlimited runs500 files/job · 50 active · unlimited runs
ExportsCSV, JSON, XLSXCSV, JSON, XLSX, PDF, WordCSV, JSON, XLSX, PDF, WordCSV, JSON, XLSX, PDF, Word
Google Drive & Sheets—✓✓✓
Local Ollama—✓✓✓
API tokens & webhooks—✓✓✓
Audit log access—✓✓✓
Inbound email——✓✓
Hosted premium models—✓✓✓
BYOK processingUp to 25 PEUp to 100 PEUnlimitedUnlimited
  • Hosted extraction stops at the monthly PE allowance, so there are no surprise overage bills. If you need more capacity, email us at support@dynamitedocs.com or contact support.
  • BYOK provider models are available on every plan; Pro and Scale use them without a PE cap.
  • Anonymous (not signed in) usage is limited to a daily anti-abuse cap.
Need more? Upgrade anytime from the footer, or check your current usage in the header. Capacity is always visible before you hit a limit.

Related workflows & guides

Next chapterKeyboard shortcuts

11

Keyboard commands for fast cell editing, row navigation, and review

Move fast, stay in the flow

Shortcuts work when the focus is outside an input field. On macOS, use ⌘ instead of Ctrl.

Extract the selected document(s)CtrlEnter
Save the active tableCtrlS
Export CSV, JSON, or XLSXCtrlShiftS
Upload a fileCtrlU
Create a new folderCtrlShiftN
Focus searchCtrlF
Select all filesCtrlA
Copy the selected filesCtrlC
Delete the selected filesDelete
Show shortcut help toast?

Related workflows & guides

Next chapterTroubleshooting

12

Fix missed rows and scan issues in AI document extraction

Common issues and quick fixes

Dynamite Docs help and documentation dialogClick to enlarge
Figure 6.1: In-app help topics and links to the full guide and support desk.

Extraction failed or returned empty

Try again once, then check the document: password-protected PDFs, dense or unusual layouts, and low-quality scans are the usual culprits. Re-scan at a higher DPI or flatten the file and retry.

I hit my monthly limit

Extraction is blocked until your allowance resets. Upgrade to Pro or Scale for unlimited BYOK processing. Need more capacity? Email us at support@dynamitedocs.com or contact support.

My files are gone after switching browsers

Browser-only storage is local to the browser it was created in. Files stored on Starter, Pro, and Scale use the plan’s cloud allowance and follow you across devices.

Local companion or Ollama is not connecting

Make sure Ollama is running and responding on port 11434 (http://127.0.0.1:11434), and that the Dynamite Docs companion is running on port 8756. Install the companion from Microsoft Store, then reconnect from AI Settings. Check the AI Keys & Setup chapter for configuration details.

My uploaded file fell back to browser-only storage

This happens when your cloud storage is full. Deleting old files frees the bytes immediately, or you can upgrade for more capacity.

Related workflows & guides

Next chapterFAQ

13

Answers to common questions about AI document extraction

Straight answers to the questions we hear most

Do I need to create templates or train the model?+

No. Upload a document and Dynamite Docs infers the schema automatically. If a field is missed, add it during review and it is remembered for the next file with the same layout.

What happens when the AI gets something wrong?+

Every field carries a confidence score. Review the results before exporting, fix anything inline, and the correction becomes a pattern so the next batch is more accurate.

What is a page-equivalent (PE)?+

Each successfully processed hosted page costs one PE. A five-page hosted extraction costs 5 PE. Free and Starter BYOK pages use the same monthly allowance. Failed extractions and Pro or Scale BYOK runs cost 0 PE. When a metered allowance is spent, processing pauses until it resets, so there are no overage charges. If you need more capacity, email us at support@dynamitedocs.com.

Is my data used to train AI models?+

Dynamite Docs does not use customer documents to train foundation models. Hosted and own-key requests are also subject to the selected provider's handling terms. Check the provider and routing policy before processing sensitive documents.

Can I use my own API keys?+

Yes, on every plan. Connect Gemini, Mistral, OpenAI, Anthropic, Groq, Cloudflare, OpenRouter, or any OpenAI-compatible endpoint. BYOK on Free and Starter uses monthly PE; BYOK on Pro and Scale is unlimited. You pay the provider directly.

Why can’t I upload a file?+

Check your plan: storage is browser-only on Free. Starter has 500 MB, Pro has 2 GB, and Scale has 10 GB of cloud storage; uploads fall back to browser-only when that allowance is full. Files over the per-document page cap must be split before extraction.

What happens when I cancel my subscription or delete my account?+

You can cancel a paid subscription at any time directly through the customer billing portal with no cancellation fees. Cancellation takes effect at the end of the paid billing period, and your account reverts to the Free tier without deleting documents or extraction history. First-time paid plans include a 7-day money-back guarantee. Full account and document deletion can be requested by emailing support@dynamitedocs.com.

Which integrations and export formats does Dynamite Docs support?+

Dynamite Docs exports to Excel (.xlsx), CSV, and JSON, with one-click direct push to Google Sheets and Google Drive. For automated pipelines, we provide a REST extraction API, HMAC-SHA256 webhooks, and direct document workflows for QuickBooks, Xero, and Tally.

Can I use a local AI model?+

Yes. Starter, Pro, and Scale include the Ollama companion. Install it from Microsoft Store to route model inference to Ollama on your machine through signed, loopback-only requests; account and workspace features remain hosted. Read our Local Document AI guide for full instructions. Get Dynamite Docs from Microsoft Store

Related workflows & guides

Next chapterContact support

14

Contact support and engineering for technical questions

Talk to a human

If the guide does not solve the issue, email us with the relevant document details, forward files to email capture, or open the support desk from the app.

Related workflows & guides

Can we save optional cookies?

Essential cookies keep you signed in. With your permission, optional analytics cookies and masked session replays help us understand usage and diagnose errors. Privacy policy. Change your choice anytime in Cookie settings.