Synupv1
Crear clave
v1Recursos/Datos/getListar carpetas

Listar carpetas

Devuelve todas las carpetas de esta agencia, con su cantidad de elementos y su mezcla de fuentes.

get/api/v1/folders
media:read
Parámetros de consulta
scopeTypestring (account | client | location | brand)opcional
Limitar a carpetas con este alcance: account, client, location o brand.
scopeIdstringopcional
Limitar a carpetas con este id de alcance. Requiere scopeType.
Respuesta
dataobjectopcional
itemsarray of objectopcional
idstringopcional
Identificador único de la carpeta.
namestringopcional
El nombre de la carpeta.
descriptionstringopcional
La descripción de la carpeta, o null.
itemCountnumberopcional
Cantidad de assets actualmente en la carpeta.
sourceMixarray of stringopcional
Las fuentes de assets distintas presentes en la carpeta.
scopeobjectopcional
El alcance de la carpeta, o null cuando es de toda la agencia.
typestring (account | client | location | brand)opcional
idstringopcional
sharingobjectopcional
El estado de uso compartido público de la carpeta.
accessstring (restricted | link)opcional
urlstringopcional
createdAtstringopcional
Cuándo se creó la carpeta, como marca de tiempo ISO 8601.
Errores
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/folders
Su clave de API
scopeType
scopeId
{
  "data": {
    "items": [
      {
        "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"
      }
    ]
  }
}