v1Ressourcen/Daten/getOrdner auflisten

Ordner auflisten

Liefert jeden Ordner dieser Agentur mit Elementanzahl und Quellen-Mix.

get/api/v1/folders

media:read

Query-Parameter

scopeTypestring (account | client | location | brand)optional

Auf Ordner eingrenzen, die diesem Geltungsbereich zugeordnet sind: account, client, location oder brand.

scopeIdstringoptional

Auf Ordner mit dieser Geltungsbereichs-ID eingrenzen. Erfordert scopeType.

Antwort

dataobjectoptional

itemsarray of objectoptional

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

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.

429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.

get/api/v1/folders

Ihr API-Schlüssel

scopeType

scopeId

{
  "data": {
    "items": [
      {
        "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"
      }
    ]
  }
}