Skip to main content
If you don’t find your question here, follow the link inside each answer to the page that goes deeper, or contact support.

​
Documents and processing

PDF, JPEG, PNG, TIFF, and HEIC. Multi-page TIFFs are supported. PDF is preferred for multi-page documents. See supported formats.
Yes. Multi-page PDFs and multi-page TIFFs run through the pipeline as a single document. When the pipeline splits the document into chunks, Ingestly creates a child run for each chunk and the parent run waits in Awaiting Children until they all finish.
The run moves to Failed status and downstream nodes do not execute. Open the run detail to inspect the failed step execution for the input it received and the error it produced.
Drop a review node after the step you want to gate. Choose Always to pause every run, LowConfidence to pause when confidence drops below a threshold, or Unverified Fields to pause whenever the upstream extract node returns unverified fields. See the human review guide.
Each pipeline has its own retention setting in days. After that window the document file and run history are removed. Configure retention on the pipeline detail page.

​
Pipelines and runs

The pipeline is probably not activated. A pipeline must be active and have valid configuration (at least one trigger, all nodes connected, validation passing) before it accepts documents.
Yes. Either branch upstream with a classify node (rules or AI similarity) and route each document type to its own subgraph, or use a route node to filter on content. See conditional routing.
The parent run paused while child runs finish. This happens when Ingestly splits a multi-page document into chunks and processes each chunk independently. The parent resumes once every child run completes.
Yes. Open the document on the pipeline detail page and re-run it. Each re-run creates a new run and consumes credits.
Create an alert rule on a metric like Failure Rate, Callback Failure Rate, or Credit Balance. Pick In-App or Email as the channel.

​
API and integration

POST the document as multipart/form-data to https://api.ingestly.ai/pipelines/{pipelineId}/trigger with your API key in the X-Api-Key header. The pipeline must have a webhook trigger. See the webhook trigger guide for code samples.
Add the X-Workspace-Id header. If you omit it, the request targets your default workspace. See API overview.
Limits scale with your plan: 10 requests per minute on Free, 60 on Basic, 300 on Standard, 1,000 on Advanced. Every response includes RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset headers. See rate limits.
Add a callback output node to your pipeline. When the run completes, Ingestly posts the results to the URL you configure. See webhooks and callbacks.
Generate a webhook signing key and verify the HMAC-SHA256 signature on the X-Ingestly-Signature header against the raw request body. The same guide covers zero-downtime key rotation.
Rotation keeps both the old and new key active and signs callbacks with both, so your integration keeps working while you cut over. Revoking removes the signature header entirely; update your application to stop verifying signatures before you revoke.

​
Billing and credits

Ingestly reserves credits upfront at run start, based on the most expensive branch your pipeline could take multiplied by the number of pages. The actual deduction matches that worst-case path, not just the steps that ended up running. See credits for the per-node breakdown and worked examples.
No. Ingestly reserves credits at run start based on the most expensive branch your pipeline could take. That reservation isn’t refunded if a later step fails, so the deduction matches the worst-case path regardless of how far the run actually got.
New organizations get 200 welcome credits so you can build and test pipelines before subscribing.
Create an alert rule on the Credit Balance metric with the Less Than operator so you get notified when your balance dips below a threshold.
Ingress triggers (upload, email, and webhook) each charge 1 credit per page. The internal forward trigger is free. Outputs (callback, email output, forward output) are free, as are review, transform, merge, HTTP action, and non-AI validation. Action cost comes from parse, extract, classify (both modes), AI validation, and route when it reads text to filter or group. See credits.

Glossary

Definitions for every term used in Ingestly

Credits

Per-node credit costs and worked examples

API overview

Authentication, headers, and the public endpoint

Quickstart

Build your first pipeline in 5 minutes