v1Ressourcen/Daten/deleteOrdner löschen

Ordner löschen

Löscht den Ordner. Seine Assets bleiben unangetastet — sie verlieren nur ihre Ordnerzugehörigkeit. itemsRemoved und shareLinksRevoked in der Antwort geben an, wie viele Dinge dabei stillschweigend mit entfernt wurden.

delete/api/v1/folders/{id}

media:write

Query-Parameter

idstringerforderlich

Der zu löschende Ordner.

Antwort

dataobjectoptional

itemsRemovednumberoptional

Anzahl der Elemente (Assets), die aus dem Ordner entfernt wurden — so viele FolderItem-Zuordnungen wurden zusammen mit ihm gelöscht.

shareLinksRevokednumberoptional

Anzahl der aktiven Freigabelinks für diesen Ordner, die beim Löschen widerrufen wurden.

Fehler

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.

delete/api/v1/folders/{id}

Ihr API-Schlüssel

id *

{
  "data": {
    "itemsRemoved": 12,
    "shareLinksRevoked": 1
  }
}