Mehrere DAM-Assets löschen
Löscht mehrere DAM-Assets in einer atomaren Operation.
https://api2.transloadit.com/ dam/ assets/ bulk/ deleteBevor Sie diesen Endpunkt aufrufen, ermitteln Sie die IDs vorhandener Assets im selben Workspace wie der für die Anfrage verwendete Auth Key.
Für Dateien, die mit /transloadit/store gespeichert wurden, rufen Sie deren Assembly Status ab und warten Sie auf ASSEMBLY_COMPLETED. Übernehmen Sie aus den zurückgegebenen results[stepName]-Arrays für jede gespeicherte Datei deren asset_id, nicht deren reguläre Datei-id. Verwenden Sie diese Werte für ASSET_ID oder params.asset_ids in den folgenden Beispielen.
Ersetzen Sie die Beispiel-IDs durch Ihre Asset-IDs; jede ID darf nur einmal vorkommen. Dadurch werden die ausgewählten Assets aus der Bibliothek des Workspaces entfernt.
Gespeicherte Objekte und unveränderliche Asset-Versionen bleiben erhalten; dies ist keine dauerhafte Löschung.
Anfragebeispiel
Führen Sie diese Anfrage in einer serverseitigen Shell mit curl und einem geeigneten Bearer-Token in TRANSLOADIT_TOKEN aus. Wenn Sie ein Token benötigen, klappen Sie die folgende Einrichtungsanleitung auf.
Benötigen Sie ein Bearer-Token?
Setzen Sie in einer vertrauenswürdigen serverseitigen Shell mit curl und jq die Variablen TRANSLOADIT_KEY und TRANSLOADIT_SECRET auf Ihren Auth Key bzw. Ihr Auth Secret. Halten Sie beide Zugangsdaten und das resultierende Token geheim; führen Sie diese Einrichtung niemals in Browsercode aus.
Erstellen Sie zunächst ein Token mit den für diesen Endpunkt erforderlichen Scopes. Ihr Auth Key muss diese Scopes bereits gewähren.
if ! TOKEN_RESPONSE="$(curl --fail-with-body -sS \
--request POST \
--url 'https://api2.transloadit.com/token' \
--user "${TRANSLOADIT_KEY:?Set TRANSLOADIT_KEY}:${TRANSLOADIT_SECRET:?Set TRANSLOADIT_SECRET}" \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'aud=api2' \
--data-urlencode 'scope=dam:write')"; then
printf '%s\n' "$TOKEN_RESPONSE" >&2
exit 1
fi
TRANSLOADIT_TOKEN="$(printf '%s' "$TOKEN_RESPONSE" |
jq -er '.access_token | strings | select(length > 0)')" || exit 1
Lassen Sie diese Shell geöffnet und führen Sie die folgende Anfrage aus. Verwenden Sie das Token wieder, solange es gültig bleibt.
curl --fail-with-body -sS --request POST \
--url "https://api2.transloadit.com/dam/assets/bulk/delete" \
--header "Authorization: Bearer ${TRANSLOADIT_TOKEN:?Set TRANSLOADIT_TOKEN}" \
--data-urlencode 'params={"asset_ids":["AAAAAAAAAAAAAAAAAAAAAA","AAAAAAAAAAAAAAAAAAAAAQ"]}'
Authentifizierung
Dieser Endpunkt akzeptiert signierte params oder ein Bearer-Token. Anweisungen zur Einrichtung finden Sie unter Authentifizierung.
Erforderlicher Berechtigungsumfang für Auth Key oder Bearer-Token: dam:write.
Signierte Anfragen erfordern sowohl eine signature als auch einen in der Zukunft liegenden Zeitstempel für params.auth.expires. Bearer-Tokens erfordern keines von beiden.
Formularfelder
Content-Type: application/x-www-form-urlencoded
params(JSON-Zeichenfolge), erforderlich. Ein JSON-codiertes Objekt, dessen unterstützte Schlüssel unten aufgeführt sind.signature(Zeichenfolge). Für signierte Anfragen erforderlich. Lassen Sie dieses Feld weg, wenn Sie ein Bearer-Token verwenden.
Unterstützte Schlüssel im Feld params
Die Authentifizierungsfelder in dieser Liste gelten für signierte Anfragen. Mit einem Bearer-Token können Sie params.auth und das separate Feld signature weglassen. Vergleichen Sie unten die Anfrageparameter der einzelnen Authentifizierungsmethoden.
Vollständiges JSON Schema
params: Es werden nur die für dieses Objekt aufgeführten Felder akzeptiert.
| Feld | Typ und Beschreibung |
|---|---|
params.erforderlich | Array<string> (minimale Anzahl Elemente: 1, maximale Anzahl Elemente: 100, keine doppelten Einträge)Schema eines Array-ElementsstringKanonische, zwischen Groß- und Kleinschreibung unterscheidende DAM-Kennung mit 22 Base64URL-Zeichen. Validierungsmuster (regulärer Ausdruck)^[A-Za-z0-9_-]{21}[AQgw]$ |
params.für signierte Anfragen erforderlich; mit einem Bearer-Token optional | Enthält den Transloadit-API-Schlüssel und Metadaten für die Signature Authentication einer DAM-Mutation.
|
params.erforderlich | stringISO-8601-Ablaufzeitstempel in der Zukunft. Erforderlich, wenn eine Anfrage signiert ist oder Signaturauthentifizierung erfordert; mit Bearer authentifizierte Anfragen können ihn weglassen. |
params.erforderlich | stringTransloadit API-Schlüssel zur Authentifizierung von Anfragen |
params. | string | integerEindeutiger Zufallswert, der in die Parameter signierter Anfragen aufgenommen wird, damit jede Signatur eindeutig ist und nicht versehentlich wiederverwendet werden kann. |
Anfrageparameter nach Authentifizierungsmethode
Mit signierten Parametern
Geben Sie Ihren Auth Key als params.auth.key an. Wenn Sie die Anfrage signieren, geben Sie einen in der Zukunft liegenden Zeitstempel für params.auth.expires an und senden Sie die Signature im separaten Feld signature. Die folgenden Felddefinitionen verwenden Pfade innerhalb von params.
Vollständiges JSON Schema
params: Es werden nur die für dieses Objekt aufgeführten Felder akzeptiert.
Verwendet die oben angegebenen Felddefinitionen: params.asset_ids, params.auth
Mit einem Bearer-Token
Senden Sie das Bearer-Token im Authorization-Header. Sie können params.auth und das separate Feld signature weglassen. Die übrigen erforderlichen Parameter müssen weiterhin angegeben werden. Die folgenden Felddefinitionen verwenden Pfade innerhalb von params.
Vollständiges JSON Schema
params: Es werden nur die für dieses Objekt aufgeführten Felder akzeptiert.
Verwendet die oben angegebenen Felddefinitionen: params.asset_ids
| Feld | Typ und Beschreibung |
|---|---|
params. | Enthält den Transloadit-API-Schlüssel und Metadaten für die Signature Authentication einer DAM-Mutation.
|
params. | stringISO-8601-Ablaufzeitstempel in der Zukunft. Erforderlich, wenn eine Anfrage signiert ist oder Signaturauthentifizierung erfordert; mit Bearer authentifizierte Anfragen können ihn weglassen. |
params. | stringTransloadit API-Schlüssel zur Authentifizierung von Anfragen |
params. | string | integerEindeutiger Zufallswert, der in die Parameter signierter Anfragen aufgenommen wird, damit jede Signatur eindeutig ist und nicht versehentlich wiederverwendet werden kann. |
Antwort
Hier sehen Sie ein Beispiel für einen Antworttext:
{
"assets": [
{
"asset_id": "AAAAAAAAAAAAAAAAAAAAAA",
"deleted_at": "2026-09-12T10:00:00.000Z"
},
{
"asset_id": "AAAAAAAAAAAAAAAAAAAAAQ",
"deleted_at": "2026-09-12T10:00:00.000Z"
}
],
"message": "The DAM assets were successfully deleted.",
"ok": "DAM_ASSETS_DELETED"
}2xx-Erfolg
JSON-Response-Body. application/json text/plain; charset=utf-8
Schema des Response-Bodys
Vollständiges JSON Schema
Die Antwort enthält nur die für dieses Objekt aufgeführten Felder.
| Feld | Typ und Beschreibung | ||||||
|---|---|---|---|---|---|---|---|
assetserforderlich | Array<object>Schema eines Array-Elements
| ||||||
messageerforderlich | string (minimale Länge: 1) | ||||||
okerforderlich | string (immer: "DAM_ASSETS_DELETED") |
Fehlerantwort
JSON-Response-Body. application/json text/plain; charset=utf-8
Schema des Response-Bodys
Vollständiges JSON Schema
Die Antwort kann zusätzliche Felder enthalten.
| Feld | Typ und Beschreibung |
|---|---|
assembly_id | string |
error | string (minimale Länge: 1) |
http_code | number | string
|
message | stringMenschenlesbare Erklärung des Fehlers. Die Formulierung kann variieren; verwenden Sie den Code |
reason | null | string | number | boolean | Array<beliebiger Wert> | objectEines der folgenden Schemas kann gelten: nullnullstringstringnumbernumberbooleanbooleanArray<beliebiger Wert>Array<beliebiger Wert>Schema eines Array-Elementsbeliebiger WertobjectobjectSchema für zusätzliche Eigenschaftenbeliebiger Wert |
HTTP 400
JSON-Response-Body. application/json text/plain; charset=utf-8
Schema des Response-Bodys
Vollständiges JSON Schema
Benannte Fehler und das allgemeine Fehlerformat
error: "DAM_INVALID_REQUEST"
Die DAM-Mutationsparameter sind ungültig.
Die Antwort kann zusätzliche Felder enthalten.
Allgemeines Fehlerformat
HTTP 404
JSON-Response-Body. application/json text/plain; charset=utf-8
Schema des Response-Bodys
Vollständiges JSON Schema
Benannte Fehler und das allgemeine Fehlerformat
error: "DAM_RESOURCE_NOT_FOUND"
Die angeforderte DAM-Ressource wurde nicht gefunden.
Die Antwort kann zusätzliche Felder enthalten.
Allgemeines Fehlerformat
HTTP 409
JSON-Response-Body. application/json text/plain; charset=utf-8
Schema des Response-Bodys
Vollständiges JSON Schema
Benannte Fehler und das allgemeine Fehlerformat
error: "DAM_MUTATION_CONFLICT"
Die DAM-Mutation steht in Konflikt mit einer bestehenden Ressource.
Die Antwort kann zusätzliche Felder enthalten.
Allgemeines Fehlerformat
HTTP 500
JSON-Response-Body. application/json text/plain; charset=utf-8
Schema des Response-Bodys
Vollständiges JSON Schema
Benannte Fehler und das allgemeine Fehlerformat
error: "DAM_MUTATION_FAILED"
Die DAM-Mutation konnte nicht abgeschlossen werden. Bitte versuchen Sie es erneut.
Die Antwort kann zusätzliche Felder enthalten.