Synup
Create a key
v1Resources/Data/getGet a folder

Get a folder

Returns one folder's detail. Its contents are GET /api/v1/assets?folderId={id}.

get/api/v1/folders/{id}
media:read
Query parameters
idstringrequired
The folder to look up.
Response
dataobjectoptional
folderobjectoptional
idstringoptional
Unique identifier for the folder.
namestringoptional
The folder's name.
descriptionstringoptional
The folder's description, or null.
itemCountnumberoptional
Number of assets currently in the folder.
sourceMixarray of stringoptional
The distinct asset sources present in the folder.
scopeobjectoptional
The folder's scope, or null when it's agency-wide.
typestring (account | client | location | brand)optional
idstringoptional
sharingobjectoptional
The folder's public-sharing state.
accessstring (restricted | link)optional
urlstringoptional
createdAtstringoptional
When the folder was created, as an ISO 8601 timestamp.
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.
get/api/v1/folders/{id}
Your API key
id *
{
  "data": {
    "folder": {
      "id": "folder_1",
      "name": "Storefront Photos",
      "description": null,
      "itemCount": 12,
      "sourceMix": [
        "upload",
        "gmb"
      ],
      "scope": {
        "type": "client",
        "id": "cli_123"
      },
      "sharing": {
        "access": "restricted",
        "url": null
      },
      "createdAt": "2026-01-15T10:00:00.000Z"
    }
  }
}