Synupv1
Schlüssel erstellen
v1Ressourcen/Daten

Daten

Die einheitliche Asset-Bibliothek hinter dem Tab „Daten“: der paginierte Multi-Source-Katalog (Uploads, generierte Bilder, synchronisierte Medien, aus GBP importierte Fotos, nutzergenerierte Medien), Ordner und das Asset-Tag-Vokabular. Unterscheidet sich von den Standort-Gruppierungs-Tags aus locations/tags.

Liefert alle in Ihrer Agentur definierten Asset-Tags.

Asset-Tags auflisten

get/api/v1/tags
media:read
Antwort
dataobjectoptional
tagsarray of objectoptional
Die Asset-Tags der Agentur.
idstringoptional
namestringoptional
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/tags
Ihr API-Schlüssel
{
  "data": {
    "tags": [
      {
        "id": "tag_1",
        "name": "VIP"
      },
      {
        "id": "tag_2",
        "name": "Seasonal"
      }
    ]
  }
}
v1Ressourcen/Daten/postEin Asset-Tag erstellen

Erstellt ein neues Asset-Tag mit dem angegebenen Namen.

Ein Asset-Tag erstellen

post/api/v1/tags
media:write
Anfragetext
namestringerforderlich
Der Name des Tags.
Antwort
dataobjectoptional
idstringoptional
Eindeutige Kennung für das neu erstellte Tag.
namestringoptional
Der Name des Tags.
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.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
post/api/v1/tags
Ihr API-Schlüssel
Anfragetext*
{
  "data": {
    "id": "tag_1",
    "name": "VIP"
  }
}
v1Ressourcen/Daten/patchAsset-Tag umbenennen

Benennt einen Tag um. Falls bereits ein anderer Tag den Zielnamen trägt, werden beide zusammengeführt: jedes mit einem der beiden getaggte Asset trägt anschließend den verbleibenden Namen.

Asset-Tag umbenennen

patch/api/v1/tags/{id}
media:write
Query-Parameter
idstringerforderlich
Der umzubenennende Tag.
Anfragetext
namestringerforderlich
Der neue Name des Tags. Erforderlich.
Antwort
dataobjectoptional
idstringoptional
Eindeutige Kennung für das neu erstellte Tag.
namestringoptional
Der Name des Tags.
countnumberoptional
Die Anzahl der Assets, die diesen Tag jetzt tragen.
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/tags/{id}
Ihr API-Schlüssel
id *
Anfragetext*
{
  "data": {
    "id": "tag_1",
    "name": "VIP Clients",
    "count": 12
  }
}
v1Ressourcen/Daten/deleteEin Asset-Tag löschen

Löscht ein Asset-Tag. Die damit verknüpften Assets werden dabei nicht gelöscht. assetsUntagged in der Antwort gibt an, wie viele Dateien den Tag verloren haben.

Ein Asset-Tag löschen

delete/api/v1/tags/{id}
media:write
Query-Parameter
idstringerforderlich
ID des zu löschenden Asset-Tags.
Antwort
dataobjectoptional
assetsUntaggednumberoptional
Anzahl der Dateien, die dieses Tag hatten — alle haben die Zuordnung verloren, als das Tag gelöscht wurde.
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/tags/{id}
Ihr API-Schlüssel
id *
{
  "data": {
    "assetsUntagged": 5
  }
}
v1Ressourcen/Daten/postAssets zu einem Tag hinzufügen

Verknüpft ein oder mehrere Assets, anhand ihres Keys, mit einem bestehenden Asset-Tag.

Assets zu einem Tag hinzufügen

post/api/v1/tags/{id}/assets
media:write
Query-Parameter
idstringerforderlich
ID des Asset-Tags.
Anfragetext
assetKeysarray of stringerforderlich
Keys der Assets, die mit diesem Tag verknüpft werden sollen.
Antwort
dataobjectoptional
addedarray of stringoptional
Keys der tatsächlich verknüpften Assets — ein Asset, das dieses Tag bereits trägt, wird nicht doppelt verknüpft.
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.
post/api/v1/tags/{id}/assets
Ihr API-Schlüssel
id *
Anfragetext*
{
  "data": {
    "added": [
      "upload:abc123",
      "gmb:xyz789"
    ]
  }
}
v1Ressourcen/Daten/deleteEin Asset von einem Tag entfernen

Trennt ein einzelnes Asset, anhand seines Keys, von einem Asset-Tag.

Ein Asset von einem Tag entfernen

delete/api/v1/tags/{id}/assets
media:write
Query-Parameter
idstringerforderlich
ID des Asset-Tags.
assetKeystringerforderlich
Key des Assets, das von diesem Tag entfernt werden soll.
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.
delete/api/v1/tags/{id}/assets
Ihr API-Schlüssel
id *
assetKey *
{}
v1Ressourcen/Daten/getAssets auflisten

Liefert einen paginierten Ausschnitt des einheitlichen Asset-Katalogs, neueste zuerst — Uploads, KI-generierte Bilder, synchronisierte Medienbibliotheks-Assets, aus GBP importierte Fotos und nutzergenerierte (UGC) Medien, zu einem Feed zusammengeführt.

Assets auflisten

get/api/v1/assets
media:read
Query-Parameter
sourcestring (all | upload | gmb | generated | discovered | ugc)optional
Auf einen Quell-Tab eingrenzen: all (Standard), upload, gmb, generated, discovered oder ugc.
typestringoptional
Auf eine Asset-Art eingrenzen, z. B. image oder video.
folderIdstringoptional
Auf Assets in diesem Ordner eingrenzen.
tagstringoptional
Auf Assets mit diesem Tag-Namen eingrenzen.
locationIdstringoptional
Auf Assets eingrenzen, die diesem Standort zugewiesen sind. Nachschlagen mit GET /api/v1/locations.
clientIdstringoptional
Der Client, auf den die Ergebnisse eingegrenzt werden. Erforderlich, wenn dieser Schlüssel auf bestimmte Clients beschränkt ist und keine locationId angegeben wird. Nachschlagen mit GET /api/v1/clients.
qstringoptional
Suche nach Titel oder Dateiname.
cursorstringoptional
Paginierungs-Cursor aus dem nextCursor einer vorherigen Antwort.
limitnumberoptional
Maximale Anzahl zurückgegebener Elemente. Standard 60, maximal 200.
statusstring (needs_review | spam | ok | skipped)optional
Moderationsstatus-Filter — gilt nur, wenn source ugc ist: needs_review, spam, ok oder skipped.
Antwort
dataobjectoptional
itemsarray of objectoptional
Die Seite mit Assets.
keystringoptional
Zusammengesetzte Kennung für das Asset, im Format „<source>:<id>“.
sourcestringoptional
Herkunft dieses Assets (z. B. ein OS-Upload gegenüber einer importierten Quelle).
idstringoptional
Die ID des Assets innerhalb seiner Quelle.
titlestringoptional
Der Titel des Assets.
filenamestringoptional
Der ursprüngliche Dateiname des Assets.
mimestringoptional
Der MIME-Typ des Assets.
kindstringoptional
Die Art des Assets (Foto oder Video).
sizeBytesnumberoptional
Dateigröße in Bytes, oder null, wenn unbekannt.
urlstringoptional
Sofort nutzbare URL für die Bytes des Assets.
thumbnailUrlstringoptional
URL einer Vorschau-Miniaturansicht, oder null.
tagsarray of stringoptional
Dem Asset zugeordnete Tags.
folderIdsarray of stringoptional
Asset-Ordner, zu denen dieses Asset gehört.
locationIdsarray of stringoptional
Jeder Standort, dem dieses Asset zugeordnet ist.
nextCursorstringoptional
Beim nächsten Aufruf als cursor übergeben, um die folgende Seite zu laden. Null, wenn keine weiteren vorhanden sind.
countsobjectoptional
Gesamtsummen pro Tab (all/upload/gmb/generated/discovered/ugc), unabhängig von den aktiven Filtern.
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/assets
Ihr API-Schlüssel
source
type
folderId
tag
locationId
clientId
q
cursor
limit
status
{
  "data": {
    "items": [
      {
        "key": "upload:abc123",
        "source": "upload",
        "id": "abc123",
        "title": "Storefront photo",
        "filename": "storefront.jpg",
        "mime": "image/jpeg",
        "kind": "image",
        "sizeBytes": 482913,
        "url": "https://cdn.synup.com/media/abc123.jpg",
        "thumbnailUrl": "https://cdn.synup.com/media/abc123-thumb.jpg",
        "tags": [
          "VIP"
        ],
        "folderIds": [
          "folder_1"
        ],
        "locationIds": [
          "loc_456"
        ]
      }
    ],
    "nextCursor": null,
    "counts": {
      "all": 1,
      "upload": 1,
      "gmb": 0,
      "generated": 0,
      "discovered": 0,
      "ugc": 0
    }
  }
}
v1Ressourcen/Daten/getOrdner auflisten

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

Ordner auflisten

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"
      }
    ]
  }
}
v1Ressourcen/Daten/postOrdner erstellen

Erstellt einen neuen, leeren Ordner. Assets damit hinzufügen: POST /api/v1/folders/{id}/items.

Ordner erstellen

post/api/v1/folders
media:write
Anfragetext
namestringerforderlich
Der Name des Ordners. Erforderlich.
descriptionstringoptional
Eine optionale Beschreibung.
scopeTypestring (account | client | location | brand)optional
Optionaler Geltungsbereich: account, client, location oder brand. Ordner ohne Geltungsbereich gelten agenturweit.
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.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
post/api/v1/folders
Ihr API-Schlüssel
Anfragetext*
{
  "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"
    }
  }
}
v1Ressourcen/Daten/getOrdner abrufen

Liefert die Details eines Ordners. Sein Inhalt: GET /api/v1/assets?folderId={id}.

Ordner abrufen

get/api/v1/folders/{id}
media:read
Query-Parameter
idstringerforderlich
Der abzurufende Ordner.
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
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.
get/api/v1/folders/{id}
Ihr API-Schlüssel
id *
{
  "data": {
    "folder": {
      "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"
    }
  }
}
v1Ressourcen/Daten/patchOrdner aktualisieren

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

Ordner aktualisieren

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"
    }
  }
}
v1Ressourcen/Daten/deleteOrdner 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.

Ordner löschen

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
  }
}
v1Ressourcen/Daten/postOrdner freigeben

Erstellt (oder erneuert) einen öffentlichen Link für den Ordner. Beim Erneuern wird jeder zuvor ausgestellte Link widerrufen.

Ordner freigeben

post/api/v1/folders/{id}/share
media:write
Query-Parameter
idstringerforderlich
Der freizugebende Ordner.
Antwort
dataobjectoptional
urlstringoptional
Die öffentliche Freigabe-URL.
accessstring (link)optional
Bei Erfolg immer „link“.
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.
post/api/v1/folders/{id}/share
Ihr API-Schlüssel
id *
{
  "data": {
    "url": "https://synup.com/s/aB3dE9fGhJ",
    "access": "link"
  }
}
v1Ressourcen/Daten/deleteOrdnerfreigabe aufheben

Widerruft den öffentlichen Link des Ordners.

Ordnerfreigabe aufheben

delete/api/v1/folders/{id}/share
media:write
Query-Parameter
idstringerforderlich
Der Ordner, dessen Freigabe aufgehoben wird.
Antwort
dataobjectoptional
accessstring (restricted)optional
Bei Erfolg immer „restricted“.
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}/share
Ihr API-Schlüssel
id *
{
  "data": {
    "access": "restricted"
  }
}
v1Ressourcen/Daten/postAssets zu einem Ordner hinzufügen

Fügt jeden angegebenen Asset-Schlüssel dem Ordner hinzu. Bereits vorhandene Schlüssel werden ignoriert.

Assets zu einem Ordner hinzufügen

post/api/v1/folders/{id}/items
media:write
Query-Parameter
idstringerforderlich
Der Ordner, zu dem Assets hinzugefügt werden sollen.
Anfragetext
assetKeysarray of stringerforderlich
Opake "<source>:<id>"-Asset-Schlüssel zum Hinzufügen. Erforderlich, nicht leer.
Antwort
dataobjectoptional
idstringoptional
itemCountnumberoptional
Die Elementanzahl des Ordners nach der Änderung.
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.
post/api/v1/folders/{id}/items
Ihr API-Schlüssel
id *
Anfragetext*
{
  "data": {
    "id": "folder_1",
    "itemCount": 13
  }
}
v1Ressourcen/Daten/deleteAsset aus einem Ordner entfernen

Entfernt die Zugehörigkeit eines Assets zum Ordner. Erfolgreicher No-Op, wenn es kein Mitglied war.

Asset aus einem Ordner entfernen

delete/api/v1/folders/{id}/items
media:write
Query-Parameter
idstringerforderlich
Der Ordner, aus dem das Asset entfernt werden soll.
assetKeystringerforderlich
Der zu entfernende opake "<source>:<id>"-Asset-Schlüssel. Wird als Query-Parameter übergeben (Doppelpunkt prozentkodieren), nicht als Pfadsegment.
Antwort
dataobjectoptional
idstringoptional
itemCountnumberoptional
Die Elementanzahl des Ordners nach der Änderung.
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}/items
Ihr API-Schlüssel
id *
assetKey *
{
  "data": {
    "id": "folder_1",
    "itemCount": 12
  }
}