Skip to main content
POST
Delete 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

Deletes up to 100 CUSTOM or INFORMATION assets.

records
object[]
required

The assets to delete, 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.