EUDR workflows
Runnable, end-to-end recipes that compose the individual endpoints — ingestion, deforestation metrics, the EUDR audit trail, and the DDS filing — into the complete journey from a raw location upload to a DDS filed with EU TRACES. Where the Endpoints docs describe each call in isolation, these workflows show how they chain together, which variables thread between steps, and where each subsystem hands off to the next.
Use them as copy-and-run documentation: each step is a real request with the polling, variable capture, and assertions already wired, so you can follow the sequence in the API client or lift it straight into your own integration.
▶The two styles
| Collection | Shape | Choose it when |
|---|---|---|
| Fast Path | One call — create_audit_trail: true on the upload; the worker auto-builds the record. Collapses to upload → poll → report → authorise → submit. | Straight-through, one-commodity uploads where you want the audit record built for you with the org's default operator. |
| Comprehensive | Every step explicit — upload → stage → metrics → poll → POST /audit-trail → poll → report → authorise → submit. | You need control over plot selection/separation, want to project custom columns, or want to inspect each stage. |
Both styles exist for plots and facilities (a facility resolves to the plots beneath it via the shed linkage), and both converge on the same audit-trail record, DDS report, and TRACES filing.
▶What each workflow demonstrates
| Workflow | Source | Selection key | Highlights |
|---|---|---|---|
| Fast Path From Plots | Plot upload | (auto, from upload) | Shortest path: one upload → report → TRACES filing |
| Fast Path From Facilities | Facility upload | (auto, from upload) | Facility → shed → plot resolution, auto-built, filed |
| Audit Trail From Deforestation Metrics (Plots Only) | Plot upload | assets.task_id | Projects a custom CSV column into the report via report_data_fields |
| Audit Trail From Tagged Facilities | Facility upload | tag | Tag-driven selection spanning one or many uploads |
▶Prerequisites
- An API key with
ingestions:writeandeudr:writescopes (and the:readequivalents for polling and report export). - Deforestation must run in (or before) the flow — the audit record
snapshots the deforestation signal, so the fast path requires
metrics: ["deforestation"]in the same request.
See the EUDR endpoints overview for the underlying record → DDS lifecycle these workflows drive.