Synupv1
Crear clave
v1Recursos/Datos/getObtener una carpeta

Obtener una carpeta

Devuelve el detalle de una carpeta. Su contenido: GET /api/v1/assets?folderId={id}.

get/api/v1/folders/{id}
media:read
Parámetros de consulta
idstringobligatorio
La carpeta a consultar.
Respuesta
dataobjectopcional
folderobjectopcional
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.
404El recurso no se encontró, o no pertenece a su agencia.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/folders/{id}
Su clave de API
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"
    }
  }
}