v1Resources/Data/deleteDelete a folder

Delete a folder

Deletes the folder. Its assets are untouched — they only lose their folder membership. itemsRemoved and shareLinksRevoked in the response report how many things quietly went with it.

delete/api/v1/folders/{id}

media:write

Query parameters

idstringrequired

The folder to delete.

Response

dataobjectoptional

itemsRemovednumberoptional

Number of items (assets) that were removed from the folder — this many FolderItem assignments were deleted along with it.

shareLinksRevokednumberoptional

Number of active share links for this folder that were revoked when it was deleted.

Errors

401Missing, invalid, expired, or revoked API key.

403The key lacks the required scope, or isn't authorized for this client/location.

404The resource wasn't found, or doesn't belong to your agency.

429Too many requests. Retry after the number of seconds in the Retry-After header.

delete/api/v1/folders/{id}

Your API key

id *

{
  "data": {
    "itemsRemoved": 12,
    "shareLinksRevoked": 1
  }
}