01 Upload Plot Assets

Step 1: Upload plot geometry

Mint a signed upload URL and ship the plot bytes. Identical to the canonical Asset Ingestion / 1 Upload Assets flow โ€” the docs UI's Upload tab (or any SDK) PUTs the file off meta.client_actions[0].

The CSV must carry a custom clientId column (alongside the plot geometry). That column is what step 05 projects into the report via report_data_fields; it is not a tag and not a filter key โ€” just an uploaded data column persisted on asset_entity.attributes.

Request

POST /ingestions/assets with Content-Type: application/json

FieldRequiredNotes
location_typeYesplot for this workflow
commodity_typeYese.g. coffee
metricsNoOmit here โ€” deforestation is triggered in step 3

Response (201)

  • data.id โ€” captured into {{ddsdf_task_id}}, used by steps 2, 3, 5.
  • meta.client_actions[0] โ€” the upload descriptor + poll block.

Next Step

โ†’ Step 2: Wait For Plots Staged.