Replace delivery components
Erforderliche Berechtigungen: deliveries:patch
Ersetzt alle Komponentenzuordnungen der Lieferung durch die übergebenen Gruppen.
Alle component_ids müssen zum Projekt der Lieferung gehören; innerhalb einer Gruppe müssen sie eindeutig sein.
Verteilungswerte müssen endliche, nicht negative Zahlen sein.
Gruppen, deren distribution leer ist oder nur Nullen enthält, werden ignoriert (wie in der Web-App).
Mit einem leeren Array groups werden alle Zuordnungen entfernt.
Overview
Replaces all component assignments for the delivery with the provided groups — equivalent to saving the component overview in the web app. Each group typically combines several project components (often one per component type) that share the same quantity split across delivery line items.Permissions
Request body
Per group (groups[])
Validation and behavior
- Every
component_idmust belong to the delivery’s project. - Distribution values must be finite, non-negative numbers.
- Groups whose
distributionis empty or contains only zeros are skipped (same as the web app). - The response matches GET
/deliveries/{id}/components(including server-assignedgroup_idand enriched component metadata).
Response codes
Authorizations
API-Schlüssel zur Authentifizierung. Kontaktieren Sie Ihren Customer Success Manager, um einen API-Schlüssel zu erhalten.
Jeder Endpunkt erfordert spezifische Berechtigungen (Scopes); die erforderlichen Scopes werden pro Endpunkt angezeigt.
Path Parameters
Lieferungs-ID (UUID)
Body
Liste der Komponentengruppen; leeres Array entfernt alle Zuordnungen
Response
Komponentengruppen nach der Aktualisierung (gleiche Struktur wie GET)