Obtener el historial de ejecuciones cron del Template
Devuelve los ticks conservados de un Template de Cron.
https://api2.transloadit.com/ templates/ {templateIdOrName}/ cron-runsEste endpoint está en fase alfa. Su URL, sus parámetros, sus respuestas y su comportamiento pueden cambiar sustancialmente y hacer que las integraciones existentes dejen de funcionar.
Establece TEMPLATE_ID_OR_NAME en un Cron Template que pertenezca al Workspace autenticado.
Esta vista previa, sujeta a control de acceso, devuelve hasta 100 activaciones de los últimos 30 días, de la más reciente a la más antigua.
Usa el valor next_before de la respuesta como before para recuperar activaciones anteriores. Un valor nulo significa
que no hay activaciones anteriores conservadas.
Cada entrada incluye las horas de programación, admisión y finalización, el resultado y un código de motivo
depurado. Las ejecuciones omitidas, solapadas, pausadas y ambiguas se conservan junto con las
Assemblies completadas. Si falta un punto de control de una Assembly, el resultado pasa a ser lost tras el tiempo de espera configurado,
que es de 10 minutos de forma predeterminada. Un punto de control inicial de la Assembly que llega tarde puede corregir ese resultado.
Una Assembly programada que se bloquea se marca de inmediato como failed con el motivo crashed_not_retried.
No se vuelve a intentar y la siguiente ejecución programada continúa con normalidad.
El campo de nivel superior cron_disabled_reason explica una detención automática de la programación actual:
consecutive_failures significa tres ejecuciones fallidas consecutivas; auth_key_unavailable,
instructions_invalid, schedule_invalid o dispatch_rejected indican un fallo permanente
de validación o envío. Corrige el problema y vuelve a habilitar la programación para reanudarla.
Esta explicación permanece disponible más allá del historial de 30 días. Al volver a habilitar la programación o cambiar sus ajustes,
se inicia una nueva revisión de la programación y se borra la explicación. Un valor nulo o ausente significa que no hay ninguna explicación
disponible; no permite determinar si la programación está habilitada o pausada.
Esta respuesta nunca incluye credenciales ni Instructions almacenadas.
Ejemplo de solicitud
Establece TEMPLATE_ID_OR_NAME en el valor de tu recurso sin aplicarle codificación porcentual.
Ejecuta esta solicitud en una shell 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 una shell de servidor de confianza 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=templates:read')"; 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 abierta esta shell y ejecuta la solicitud siguiente. Reutiliza el token mientras siga siendo válido.
curl --fail-with-body -sS --request GET --get \
--url "https://api2.transloadit.com/templates/${TEMPLATE_ID_OR_NAME:?Set TEMPLATE_ID_OR_NAME}/cron-runs" \
--header "Authorization: Bearer ${TRANSLOADIT_TOKEN:?Set TRANSLOADIT_TOKEN}" \
--data-urlencode 'params={}'
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: templates:read.
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.
Parámetros de ruta
templateIdOrName(segmento de ruta), obligatorio. patrón:^[a-z0-9-]+$, longitud mínima: 1
Parámetros de consulta
params(cadena JSON). 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 en el campo firmado 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 para las solicitudes firmadas; opcional con un token Bearer | Contiene la clave de API de Transloadit y los metadatos de Signature Authentication para una solicitud de Template.
|
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. | stringDevuelve las activaciones programadas antes de esta marca de tiempo ISO en UTC. Omite este parámetro para obtener la página más reciente; usa el valor Patrón de validación (expresión regular)^(([0-9][0-9][2468][048]|[0-9][0-9][13579][26]|[0-9][0-9]0[48]|[02468][048]00|[13579][26]00)-02-29|[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|1[0-9]|2[0-8])))T([01][0-9]|2[0-3]):[0-5][0-9](:[0-5][0-9](\.[0-9]+)?)?(Z)$ |
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. |
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.auth, params.before, params.nonce
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.before, params.nonce
| Campo | Tipo y descripción |
|---|---|
params. | Contiene la clave de API de Transloadit y los metadatos de Signature Authentication para una solicitud de Template.
|
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 |
Respuesta
Este es un ejemplo del cuerpo de la respuesta:
{
"message": "Your Template was successfully found.",
"next_before": null,
"ok": "TEMPLATE_FOUND",
"runs": [
{
"admitted_at": "2026-09-12T10:00:00.100Z",
"assembly_id": "31f8e3baa9ef4fb1bfc76e8267746c4c",
"attempts": 1,
"completed_at": "2026-09-12T10:00:02.000Z",
"generation": "1",
"id": "66530f0d34f041e98b3050b467e280f9",
"instructions_hash": "5a69d6a0b248c5f042aa76ba4c34e52ab81fcda8d486e068ef9e33f8bdc00f8d",
"missed_count": "0",
"missed_from": null,
"missed_through": null,
"outcome": "succeeded",
"reason": null,
"recovery_assembly_id": null,
"region": "us-east-1",
"scheduled_at": "2026-09-12T10:00:00.000Z"
}
],
"template_id": "8fc3b9166c784afd824acf24269ebd11"
}é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 | ||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
cron_disabled_reason | "auth_key_unavailable" | "consecutive_failures" | "dispatch_rejected" | "instructions_invalid" | "schedule_invalid" | null | ||||||||||||||||||||||||||||||||
messageobligatorio | string (longitud mínima: 1) | ||||||||||||||||||||||||||||||||
next_beforeobligatorio | string | nullPatrón de validación (expresión regular)^(([0-9][0-9][2468][048]|[0-9][0-9][13579][26]|[0-9][0-9]0[48]|[02468][048]00|[13579][26]00)-02-29|[0-9]{4}-((0[13578]|1[02])-(0[1-9]|[12][0-9]|3[01])|(0[469]|11)-(0[1-9]|[12][0-9]|30)|(02)-(0[1-9]|1[0-9]|2[0-8])))T([01][0-9]|2[0-3]):[0-5][0-9](:[0-5][0-9](\.[0-9]+)?)?(Z)$ | ||||||||||||||||||||||||||||||||
okobligatorio | string (siempre: "TEMPLATE_FOUND") | ||||||||||||||||||||||||||||||||
runsobligatorio | Array<object> (cantidad máxima de elementos: 100)Esquema de los elementos del array
| ||||||||||||||||||||||||||||||||
template_idobligatorio | string |
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: nullstringnumberbooleanArray<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: "SIGNATURE_REUSE_DETECTED"
La solicitud fue denegada por motivos de seguridad. Si crees que esto es un error, ponte en contacto con soporte.
La respuesta puede contener campos adicionales.
Formato general de error
error: "TEMPLATE_VALIDATION_ERROR"
Tu Template no pasó la validación.
La respuesta puede contener campos adicionales.