Skip to main content
PATCH
Update assets in a batch

Authorizations

Authorization
string
header
required

Access token from POST /oauth/token.

Headers

Idempotency-Key
string
required

A unique key, up to 256 characters, that makes the request safe to retry. Use a new UUID for each distinct request. If you send the same key again, you get the first response back, for at least 24 hours after the first request completes. Only successful (2xx) responses are stored. If the first request is still running, you get 409 idempotency_in_progress: wait the number of seconds in Retry-After, then retry. See Idempotency.

Maximum string length: 256
Example:

"b0f8e5a2-3c1d-4e6f-8a9b-0c1d2e3f4a5b"

Body

application/json

Updates up to 100 CUSTOM or INFORMATION assets, each with its own values. tags are only supported by the single-asset PATCH.

records
object[]
required

The assets to update, 1-100. Each id can appear only once.

Required array length: 1 - 100 elements

Response

Every record was processed. Check status on each entry in results; each entry has the record's index. Resend only the failed records, with a new Idempotency-Key.

Results of a batch request, one per record. The response is 200 even when some or all records failed. Resend only the failed records, with a new Idempotency-Key.

results
object[]

One result per record, in request order.