Delete media
Deletes a file from the media library, with every placement it has, or deletes an embed. To take a file off one record and keep it everywhere else, remove that placement instead.
/api/v2/media/{media}Deletes a file from the media library, with every placement it has, or deletes an embed. To take a file off one record and keep it everywhere else, remove that placement instead.
Authorization
bearerAuth In: header
Path Parameters
The file's id.
uuidQuery Parameters
Optional account to run this request against. Defaults to the account the API token is scoped to, so callers with a single account can omit it. Must be an account the authenticated user belongs to; staff may target any account. For write requests the value may be sent in the JSON body instead of the query string. The resolved account is returned on the X-Resi-Account-Id response header.
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/api/v2/media/497f6eca-6276-4993-bfeb-53cbbbba6f08"Update media PATCH
Previous Page
Import media in bulk POST
Imports up to 100 items in one request. Every item runs through the same validation, authorization and dedup as POST /api/v2/media, independently and in order: one failing item is reported in its result and does not roll back or stop the others, so the response is 200 whenever the envelope itself is valid. Files are downloaded while the request runs. After 40 seconds the batch cuts short any download still under way (that item fails with `422`) and returns the items it did not start with status `503` (not attempted), so a batch of many new files may need to be resent in parts; retry only those indexes. Files may come from at most 25 different hosts per batch; an item from a further host fails with `422`. Limited to 10 batches a minute.