Synupv1
Schlüssel erstellen
v1Ressourcen/Daten/patchOrdner aktualisieren

Ordner aktualisieren

Benennt einen Ordner um oder bearbeitet seine Beschreibung oder seinen Geltungsbereich.

patch/api/v1/folders/{id}
media:write
Query-Parameter
idstringerforderlich
Der zu aktualisierende Ordner.
Anfragetext
namestringoptional
Neuer Name.
descriptionstringoptional
Neue Beschreibung, oder null, um sie zu löschen.
scopeTypestring (account | client | location | brand)optional
Neuer Geltungsbereichstyp: account, client, location oder brand.
scopeIdstringoptional
Die ID zu scopeType, falls angegeben.
Antwort
dataobjectoptional
folderobjectoptional
idstringoptional
Eindeutige Kennung des Ordners.
namestringoptional
Der Name des Ordners.
descriptionstringoptional
Die Beschreibung des Ordners, oder null.
itemCountnumberoptional
Anzahl der Assets, die sich derzeit im Ordner befinden.
sourceMixarray of stringoptional
Die im Ordner vorhandenen, unterschiedlichen Asset-Quellen.
scopeobjectoptional
Der Geltungsbereich des Ordners, oder null, wenn er agenturweit gilt.
typestring (account | client | location | brand)optional
idstringoptional
sharingobjectoptional
Der Freigabestatus des Ordners.
accessstring (restricted | link)optional
urlstringoptional
createdAtstringoptional
Wann der Ordner erstellt wurde, als ISO-8601-Zeitstempel.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
patch/api/v1/folders/{id}
Ihr API-Schlüssel
id *
Anfragetext
{
  "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"
    }
  }
}