Synupv1
Créer une clé
v1Ressources/Données/getLister les dossiers

Lister les dossiers

Renvoie chaque dossier de cette agence, avec son nombre d'éléments et son mélange de sources.

get/api/v1/folders
media:read
Paramètres de requête
scopeTypestring (account | client | location | brand)facultatif
Limiter aux dossiers ayant cette portée : account, client, location ou brand.
scopeIdstringfacultatif
Limiter aux dossiers ayant cet id de portée. Nécessite scopeType.
Réponse
dataobjectfacultatif
itemsarray of objectfacultatif
idstringfacultatif
Identifiant unique du dossier.
namestringfacultatif
Le nom du dossier.
descriptionstringfacultatif
La description du dossier, ou null.
itemCountnumberfacultatif
Nombre d'assets actuellement dans le dossier.
sourceMixarray of stringfacultatif
Les sources d'assets distinctes présentes dans le dossier.
scopeobjectfacultatif
La portée du dossier, ou null lorsqu'il vaut pour toute l'agence.
typestring (account | client | location | brand)facultatif
idstringfacultatif
sharingobjectfacultatif
L'état de partage public du dossier.
accessstring (restricted | link)facultatif
urlstringfacultatif
createdAtstringfacultatif
Date de création du dossier, au format ISO 8601.
Erreurs
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
get/api/v1/folders
Votre clé 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"
      }
    ]
  }
}