Synupv1
Créer une clé
v1Ressources/Données/getObtenir un dossier

Obtenir un dossier

Renvoie le détail d'un dossier. Son contenu : GET /api/v1/assets?folderId={id}.

get/api/v1/folders/{id}
media:read
Paramètres de requête
idstringobligatoire
Le dossier à consulter.
Réponse
dataobjectfacultatif
folderobjectfacultatif
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.
404La ressource est introuvable, ou n'appartient pas à votre agence.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
get/api/v1/folders/{id}
Votre clé 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"
    }
  }
}