Synupv1
Créer une clé
v1Ressources/Données/patchMettre à jour un dossier

Mettre à jour un dossier

Renomme un dossier ou modifie sa description ou sa portée.

patch/api/v1/folders/{id}
media:write
Paramètres de requête
idstringobligatoire
Le dossier à mettre à jour.
Corps de la requête
namestringfacultatif
Nouveau nom.
descriptionstringfacultatif
Nouvelle description, ou null pour l'effacer.
scopeTypestring (account | client | location | brand)facultatif
Nouveau type de portée : account, client, location ou brand.
scopeIdstringfacultatif
L'id pour scopeType, le cas échéant.
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
400Il manque un paramètre requis à la requête, ou elle est invalide.
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.
patch/api/v1/folders/{id}
Votre clé API
id *
Corps de la requête
{
  "data": {
    "folder": {
      "id": "folder_1",
      "name": "Storefront Photos (2026)",
      "description": "Current-season storefront shots",
      "itemCount": 12,
      "sourceMix": [
        "upload",
        "gmb"
      ],
      "scope": {
        "type": "client",
        "id": "cli_123"
      },
      "sharing": {
        "access": "restricted",
        "url": null
      },
      "createdAt": "2026-01-15T10:00:00.000Z"
    }
  }
}