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

Créer un dossier

Crée un nouveau dossier vide. Ajoutez-y des assets avec POST /api/v1/folders/{id}/items.

post/api/v1/folders
media:write
Corps de la requête
namestringobligatoire
Le nom du dossier. Obligatoire.
descriptionstringfacultatif
Une description facultative.
scopeTypestring (account | client | location | brand)facultatif
Portée facultative : account, client, location ou brand. Un dossier sans portée est valable pour toute l'agence.
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.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
post/api/v1/folders
Votre clé API
Corps de la requête*
{
  "data": {
    "folder": {
      "id": "folder_1",
      "name": "Storefront Photos",
      "description": null,
      "itemCount": 0,
      "sourceMix": [],
      "scope": null,
      "sharing": {
        "access": "restricted",
        "url": null
      },
      "createdAt": "2026-01-15T10:00:00.000Z"
    }
  }
}