Skip to main content
Never repeated. The API accepts no idempotency key here, so a second send is a second write. Only 429 rate_limit.exceeded is retried.

Example

Parameters

string
required
Unit id.
string
Unique identifier for the unit within the credential’s environment. Cannot be cleared.
string | null
Human-readable name for the unit. Send null to clear.
string | null
Plain-text description of the unit, 1 to 10,000 characters. Send null to clear.
object | null
Free-form JSON attributes. Replaces the full stored set, so send every attribute to keep. Send null to clear all.
string | null
Tap redirect URL for this unit. Send null to clear.

Returns

200 - Unit.
string
required
string | null
required
string | null
required
string | null
required
Plain-text description of the unit. Null when none.
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.