Attach Supplier Locations
Attach an existing supplier to locations that are already in Epoch โ the post-upload counterpart to ingestion-time supplier linking. Use it when locations were uploaded without supplier data, or when a supplier must be assigned or corrected after the fact, without re-uploading.
The link written is the same one ingestion writes, so the supplier flows into any DDS built from those locations through the normal plot โ shed โ facility resolution.
โถPath parameter
| Param | Description |
|---|---|
id | The supplier's UUID or your external_id. Resolved as a UUID first, then as your organization's external_id (supplierid). |
โถBody
Provide location_ids and/or asset_task_ids โ at least one is
required. Each accepts a single value or an array.
| Field | Type | Description |
|---|---|---|
location_ids | string | string[] | Staged-location id(s) โ the id field from GET /locations. Up to 500. |
asset_task_ids | string | string[] | Asset task id(s); attaches the supplier to every location in those uploads. Up to 500. |
โถBehaviour
- Latest-wins: attaching a different supplier to a location replaces the existing link.
- Partial success: ids that don't resolve to a location visible to
your organization are reported in
meta.unresolved_location_ids/meta.unresolved_asset_task_ids; the request still succeeds for the ids that did resolve. - Scope: everything is scoped to your acting organization. As a
parent organization, use
x-acting-asto attach to a child organization's locations. - Per-request cap: each arm accepts up to 500 ids, but
asset_task_idsexpand to every location in those uploads. A request that resolves to more than 10,000 distinct locations is rejected with413 PAYLOAD_TOO_LARGEbefore any link is written โ narrow theasset_task_ids/location_idsand retry. 404only when the supplier (the addressed resource) is unknown or not linked to your organization. An empty body (neither arm) is400.
โถResponse meta
| Field | Description |
|---|---|
attached_staged_location_count | Distinct staged-locations the supplier was linked to. |
attached_location_ids | Resolved ids from the location_ids arm (the asset_task_ids arm contributes to the count but not this list). |
unresolved_location_ids | location_ids that didn't resolve to a visible location. |
unresolved_asset_task_ids | asset_task_ids that resolved to no visible locations. |
Required scope:
parties:write