Skip to main content
PUT

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

The API key must be linked to a customer. Supplier API keys cannot use this endpoint.

Request body

Per group (groups[])

Validation and behavior

  • Every component_id must belong to the delivery’s project.
  • Distribution values must be finite, non-negative numbers.
  • Groups whose distribution is empty or contains only zeros are skipped (same as the web app).
  • The response matches GET /deliveries/{id}/components (including server-assigned group_id and enriched component metadata).

Response codes

Authorizations

X-API-Key
string
header
required

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

id
string<uuid>
required

Lieferungs-ID (UUID)

Body

application/json
groups
object[]
required

Liste der Komponentengruppen; leeres Array entfernt alle Zuordnungen

Response

Komponentengruppen nach der Aktualisierung (gleiche Struktur wie GET)

groups
object[]
required