v1Resources/Locations/deleteDelete a location's photos

Delete a location's photos

Removes photos from a location. Pass urls to delete specific photos, or category to clear a whole category. The logo can never be deleted through this endpoint — by url or by category — upload a new LOGO image to replace it instead. This removes the photos in the app; it does not delete them from Google.

delete/api/v1/locations/{id}/media
locations:write
Query parameters
idstringrequired
The location to remove photos from.
Request body
urlsarray of stringoptional
Specific photo URLs to remove (from a location's mediaByCategory).
categorystring (COVER | PROFILE | EXTERIOR | INTERIOR | PRODUCT | FOOD_AND_DRINK | MENU | AT_WORK | TEAMS | ROOMS | COMMON_AREA | ADDITIONAL)optional
Clear every photo in this category. LOGO is not an allowed value — the logo can't be deleted.
Response
dataobjectoptional
mediaByCategoryobjectoptional
Media items grouped by category (e.g. EXTERIOR, INTERIOR, FOOD_AND_DRINK, LOGO, TEAMS). Each item has a url, and optionally a label, kind (PHOTO or VIDEO), source, starred flag, and asset key.
Errors
400The request is missing a required parameter or is otherwise malformed.
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.
422The request is missing a required parameter or is otherwise malformed.
429Too many requests. Retry after the number of seconds in the Retry-After header.
delete/api/v1/locations/{id}/media
Your API key
id *
Request body
{
  "data": {
    "mediaByCategory": {
      "EXTERIOR": []
    },
    "removed": [
      "https://cdn.synup.com/media/1.jpg"
    ]
  }
}