endstate.chips.pairBulk - Endstate API

pairBulk(body: CreateChipsBulkRequest, options?: IdempotentRequestOptions): Promise<CreateChipsBulkResponse>


Endpoint	`POST /v1/chips/bulk`
Credential	Secret key (`end_sk_...`)
Retry class	`keyed`
Idempotency key	Accepted

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

Example

const result = await endstate.chips.pairBulk({
  chips: [],
});

Parameters

object[]

required

Returns

201 - CreateChipsBulkResponse.

object[]

required

Errors

Branch on error.code, never on the HTTP status - several codes share one.

Code	HTTP	Retry
`auth.forbidden`	403	Do not retry
`auth.unauthorized`	401	Do not retry
`chip.already_paired`	409	Do not retry
`chip.bulk_mixed_collections`	400	Do not retry
`chip.bulk_pending`	409	Wait, then retry
`chip.invalid_e_value`	422	Do not retry
`chip.not_found`	404	Do not retry
`collection.not_active`	409	Wait, then retry
`idempotency.in_progress`	409	Safe to retry
`idempotency.key_conflict`	409	Do not retry
`internal.error`	500	Safe to retry
`unit.issuance_pending`	409	Wait, then retry
`unit.not_found`	404	Do not retry
`validation.failed`	400	Do not retry

See Errors and retries for the error types and how to narrow them.