Mover activos DAM en bloque
Mueve varios activos DAM a una carpeta de forma atómica.
https://api2.transloadit.com/Antes de llamar a este endpoint, obtén los IDs de los activos existentes en el mismo Workspace que la Auth Key utilizada para la solicitud.
Para los archivos almacenados con /transloadit/store, obtén su Assembly Status y espera a ASSEMBLY_COMPLETED. En los arrays results[stepName] devueltos, conserva el asset_id de cada archivo almacenado, no su id de archivo habitual. Usa estos valores para ASSET_ID o params.asset_ids en los ejemplos siguientes.
Para un destino que no sea la raíz, ya debes conocer el ID de la carpeta existente en el mismo Workspace. Una respuesta de traslado o cambio de nombre guardada previamente puede proporcionar este ID: folder_id de una respuesta para un solo activo o assets[].folder_id de una respuesta de traslado masivo. Estas respuestas describen la carpeta después de esa operación; no son una API de descubrimiento de carpetas.
Actualmente no hay ningún endpoint público para buscar el ID de una carpeta DAM por su ruta. Si aún no tienes el ID de la carpeta de destino, contacta con soporte antes de intentar un traslado a una carpeta que no sea la raíz. Para trasladar a la raíz, usa destination_folder_id: null.
Envía los IDs de los activos y la carpeta de destino juntos dentro de params. El ejemplo de solicitud
siguiente traslada dos activos a la raíz con un token Bearer.
Sustituye los IDs del ejemplo por los IDs de tus activos; cada ID debe aparecer una sola vez. A diferencia de un cambio de nombre de un solo activo, el traslado masivo requiere un destino explícito. Si no se puede trasladar alguno de los activos seleccionados, toda la operación falla.
Ejemplo de solicitud
Ejecuta esta solicitud en un intérprete de comandos del lado del servidor con curl y un token Bearer adecuado en TRANSLOADIT_TOKEN. Si necesitas un token, despliega la configuración siguiente.
¿Necesitas un token Bearer?
En un intérprete de comandos de confianza del lado del servidor con curl y jq, establece TRANSLOADIT_KEY y TRANSLOADIT_SECRET con los valores de tu Auth Key y tu Auth Secret. Mantén en secreto ambas credenciales y el token resultante; nunca ejecutes esta configuración en código del navegador.
Primero, crea un token con los ámbitos requeridos por este endpoint. Tu Auth Key ya debe conceder esos ámbitos.
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
Mantén abierto este intérprete de comandos y ejecuta la solicitud siguiente. Reutiliza el token mientras siga siendo válido.
curl --fail-with-body -sS --request POST \
--url "https://api2.transloadit.com/dam/assets/bulk/move" \
--header "Authorization: Bearer ${TRANSLOADIT_TOKEN:?Set TRANSLOADIT_TOKEN}" \
--data-urlencode 'params={"asset_ids":["AAAAAAAAAAAAAAAAAAAAAA","AAAAAAAAAAAAAAAAAAAAAQ"],"destination_folder_id":null}'
Autenticación
Este endpoint acepta params firmados o un token Bearer. Consulta Autenticación para ver las instrucciones de configuración.
Ámbito requerido para el Auth Key o el token de portador: dam:write.
Las solicitudes firmadas requieren tanto una signature como una marca de tiempo futura en params.auth.expires. Los tokens Bearer no requieren ninguno de estos dos elementos.
Campos del formulario
Tipo de contenido: application/x-www-form-urlencoded
params(cadena JSON), obligatorio. Un objeto codificado en JSON cuyas claves compatibles se enumeran a continuación.signature(cadena). Obligatorio para las solicitudes firmadas. Omite este campo cuando uses un token Bearer.
Claves admitidas dentro del campo params
Los campos de autenticación de esta lista se aplican a las solicitudes firmadas. Con un token Bearer puedes omitir params.auth y el campo separado signature. Compara a continuación los parámetros de solicitud de cada método de autenticación.
JSON Schema completo
params: Solo se aceptan los campos enumerados para este objeto.
| Campo | Tipo y descripción |
|---|---|
params.obligatorio | Array<string> (cantidad mínima de elementos: 1, cantidad máxima de elementos: 100, sin elementos duplicados)Esquema de los elementos del arraystringIdentificador DAM canónico de 22 caracteres Base64URL que distingue entre mayúsculas y minúsculas. Patrón de validación (expresión regular)^[A-Za-z0-9_-]{21}[AQgw]$ |
params.obligatorio para las solicitudes firmadas; opcional con un token Bearer | Contiene la clave de API de Transloadit y los metadatos de Signature Authentication para una mutación de DAM.
|
params.obligatorio | stringMarca de tiempo de vencimiento ISO 8601 en el futuro. Es obligatoria cuando una solicitud está firmada o requiere autenticación mediante firma; las solicitudes autenticadas con Bearer pueden omitirla. |
params.obligatorio | stringClave de API de Transloadit utilizada para autenticar solicitudes |
params. | string | integerValor aleatorio y único incluido en los parámetros de las solicitudes firmadas para que cada firma sea única y evitar su reutilización accidental. |
params.obligatorio | string | nullID de la carpeta de destino para todos los recursos seleccionados. Establécelo en Puede aplicarse cualquiera de los esquemas siguientes: stringstringIdentificador DAM canónico de 22 caracteres Base64URL que distingue entre mayúsculas y minúsculas. Patrón de validación (expresión regular)^[A-Za-z0-9_-]{21}[AQgw]$nullnull |
Parámetros de solicitud según el método de autenticación
Con parámetros firmados
Incluye tu Auth Key como params.auth.key. Al firmar la solicitud, incluye una marca de tiempo futura en params.auth.expires y envía la Signature en el campo separado signature. Las definiciones de los campos que aparecen a continuación usan rutas dentro de params.
JSON Schema completo
params: Solo se aceptan los campos enumerados para este objeto.
Utiliza las definiciones de campos indicadas arriba: params.asset_ids, params.auth, params.destination_folder_id
Con un token Bearer
Envía el token Bearer en el encabezado Authorization. Puedes omitir params.auth y el campo independiente signature. Los demás parámetros obligatorios siguen siendo necesarios. Las definiciones de los campos que aparecen a continuación usan rutas dentro de params.
JSON Schema completo
params: Solo se aceptan los campos enumerados para este objeto.
Utiliza las definiciones de campos indicadas arriba: params.asset_ids, params.destination_folder_id
| Campo | Tipo y descripción |
|---|---|
params. | Contiene la clave de API de Transloadit y los metadatos de Signature Authentication para una mutación de DAM.
|
params. | stringMarca de tiempo de vencimiento ISO 8601 en el futuro. Es obligatoria cuando una solicitud está firmada o requiere autenticación mediante firma; las solicitudes autenticadas con Bearer pueden omitirla. |
params. | stringClave de API de Transloadit utilizada para autenticar solicitudes |
params. | string | integerValor aleatorio y único incluido en los parámetros de las solicitudes firmadas para que cada firma sea única y evitar su reutilización accidental. |
Respuesta
Este es un ejemplo del cuerpo de la respuesta:
{
"assets": [
{
"asset_id": "AAAAAAAAAAAAAAAAAAAAAA",
"deleted_at": null,
"filename": "renamed.jpg",
"folder_id": null,
"path": "renamed.jpg",
"updated_at": "2026-09-12T10:00:00.000Z"
},
{
"asset_id": "AAAAAAAAAAAAAAAAAAAAAQ",
"deleted_at": null,
"filename": "second.jpg",
"folder_id": null,
"path": "second.jpg",
"updated_at": "2026-09-12T10:00:00.000Z"
}
],
"message": "The DAM assets were successfully moved.",
"ok": "DAM_ASSETS_MOVED"
}éxito 2xx
Cuerpo de respuesta JSON. application/json text/plain; charset=utf-8
Esquema del cuerpo de la respuesta
JSON Schema completo
La respuesta contiene únicamente los campos listados para este objeto.
| Campo | Tipo y descripción | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
assetsobligatorio | Array<object>Esquema de los elementos del array
| ||||||||||||||
messageobligatorio | string (longitud mínima: 1) | ||||||||||||||
okobligatorio | string (siempre: "DAM_ASSETS_MOVED") |
Respuesta de error
Cuerpo de respuesta JSON. application/json text/plain; charset=utf-8
Esquema del cuerpo de la respuesta
JSON Schema completo
La respuesta puede contener campos adicionales.
| Campo | Tipo y descripción |
|---|---|
assembly_id | string |
error | string (longitud mínima: 1) |
http_code | number | string
|
message | stringExplicación del error legible por humanos. Su redacción puede variar; usa el código |
reason | null | string | number | boolean | Array<cualquier valor> | objectPuede aplicarse cualquiera de los esquemas siguientes: nullnullstringstringnumbernumberbooleanbooleanArray<cualquier valor>Array<cualquier valor>Esquema de los elementos del arraycualquier valorobjectobjectEsquema de propiedades adicionalescualquier valor |
HTTP 400
Cuerpo de respuesta JSON. application/json text/plain; charset=utf-8
Esquema del cuerpo de la respuesta
JSON Schema completo
Errores con nombre y el formato general de error
error: "DAM_INVALID_REQUEST"
Los parámetros de mutación de DAM no son válidos.
La respuesta puede contener campos adicionales.
Formato general de error
HTTP 404
Cuerpo de respuesta JSON. application/json text/plain; charset=utf-8
Esquema del cuerpo de la respuesta
JSON Schema completo
Errores con nombre y el formato general de error
error: "DAM_RESOURCE_NOT_FOUND"
No se encontró el recurso DAM solicitado.
La respuesta puede contener campos adicionales.
Formato general de error
HTTP 409
Cuerpo de respuesta JSON. application/json text/plain; charset=utf-8
Esquema del cuerpo de la respuesta
JSON Schema completo
Errores con nombre y el formato general de error
error: "DAM_MUTATION_CONFLICT"
La mutación de DAM entra en conflicto con un recurso existente.
La respuesta puede contener campos adicionales.
Formato general de error
HTTP 500
Cuerpo de respuesta JSON. application/json text/plain; charset=utf-8
Esquema del cuerpo de la respuesta
JSON Schema completo
Errores con nombre y el formato general de error
error: "DAM_MUTATION_FAILED"
No se pudo completar la mutación de DAM. Inténtalo de nuevo.
La respuesta puede contener campos adicionales.