Skip to main content
Carries an idempotency key. Retried on network failure, timeout, 429, and 409 idempotency.in_progress - never on a 5xx.

Example

Parameters

string
Unique identifier for the unit within your organization.
string
Human-readable name for the unit.
object
Free-form JSON attributes for the unit.
string
required
Collection this unit belongs to.
string | null
Tap redirect URL for this unit. Omit or null for none.

Returns

201 - Unit.
string
required
string | null
required
string | null
required
object | null
required
string
required
string | null
required
Tap redirect URL for this unit; takes precedence over product/collection/org defaults.
object | null
required
The unit’s collection. Null only for units created before collections existed.
object[]
required
Chips paired to this unit.

Errors

Branch on error.code, never on the HTTP status - several codes share one. See Errors and retries for the error types and how to narrow them.