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
| Field | Required | Notes |
|---|---|---|
location_type | Yes | plot for this workflow |
commodity_type | Yes | e.g. coffee |
metrics | No | Omit 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 +pollblock.
โถNext Step
โ Step 2: Wait For Plots Staged.