Skip to main content
PUT

Übersicht

Ersetzt alle Komponentenzuordnungen der Lieferung durch den übergebenen Satz von Gruppen. Das entspricht dem Speichern der Komponentenübersicht in der Web-App: jede Gruppe bündelt mehrere Projektkomponenten (üblicherweise eine pro Komponententyp), die dieselbe Mengenverteilung auf die Lieferpositionen teilen.

Berechtigungen

Der API-Schlüssel muss mit einem Kunden verknüpft sein. Lieferanten-API-Schlüssel können diesen Endpunkt nicht verwenden.

Anfragetext

Pro Gruppe (groups[])

Validierung und Verhalten

  • Alle component_ids müssen zum Projekt der Lieferung gehören.
  • Verteilungswerte müssen endliche, nicht negative Zahlen sein.
  • Gruppen mit leerer distribution oder nur Nullwerten werden ignoriert (wie in der Web-App).
  • Die Antwort hat dieselbe Form wie GET /deliveries/{id}/components (inkl. serverseitig vergebener group_id und angereicherter Komponentenmetadaten).

Response Codes

Autorisierungen

X-API-Key
string
header
erforderlich

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.

Pfadparameter

id
string<uuid>
erforderlich

Lieferungs-ID (UUID)

Body

application/json
groups
object[]
erforderlich

Liste der Komponentengruppen; leeres Array entfernt alle Zuordnungen

Antwort

Komponentengruppen nach der Aktualisierung (gleiche Struktur wie GET)

groups
object[]
erforderlich