Retrieve Cron Template run history
Returns retained ticks for a Cron Template.
https://api2.transloadit.com/ templates/ {templateIdOrName}/ cron-runsThis endpoint is in alpha. Its URL, parameters, responses, and behavior may change substantially and break existing integrations.
Set TEMPLATE_ID_OR_NAME to a Cron Template owned by the authenticated Workspace.
This invited paid preview returns up to 100 ticks from the past 30 days, newest first.
Use the response’s next_before value as before to retrieve older ticks. A null value means
there are no older retained ticks.
Each entry includes its scheduled, admission, and completion times, outcome, and a sanitized
reason code. Skipped, overlapping, paused, and ambiguous runs are retained alongside completed
Assemblies. A missing Assembly checkpoint becomes lost after the configured timeout,
which defaults to 10 minutes. A crashed Assembly awaiting recovery has the same bounded wait.
These lost outcomes may be corrected if an Assembly or its recovery appears later.
Credentials and stored Instructions are never included in this response.
Request example
Set TEMPLATE_ID_OR_NAME to your resource value without percent-encoding it.
Run this request in a server-side shell with curl and a suitable bearer token in TRANSLOADIT_TOKEN. If you need a token, expand the setup below.
Need a bearer token?
In a trusted server-side shell with curl and jq, set TRANSLOADIT_KEY and TRANSLOADIT_SECRET to your Auth Key and Auth Secret. Keep both credentials and the resulting token secret; never run this setup in browser code.
First, create a token with this endpoint’s required scopes. Your Auth Key must already grant those scopes.
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
Keep this shell open and run the request below. Reuse the token while it remains valid.
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={}'
Authentication
This endpoint accepts signed params or a bearer token. See Authentication for setup instructions.
Required scope for the Auth Key or bearer token: templates:read.
Signed requests require both a signature and a future params.auth.expires timestamp. Bearer tokens do not require either.
Path parameters
templateIdOrName(path segment), required. pattern:^[a-z0-9-]+$, minimum length: 1
Query parameters
params(JSON string). A JSON-encoded object whose supported keys are listed below.signature(string). Required for signed requests. Omit this field when using a bearer token.
Supported keys inside the signed params field
Authentication fields in this list apply to signed requests. With a bearer token, you can omit params.auth and the separate signature field. Compare the authentication-specific request parameters below.
Complete JSON Schema
params: Only the fields listed for this object are accepted.
| Field | Type and description |
|---|---|
params.required for signed requests; optional with a bearer token | Contains the Transloadit API key and signature-authentication metadata for a Template request.
|
params.required | stringISO 8601 expiration timestamp in the future. Required when a request is signed or requires signature authentication; bearer-authenticated requests may omit it. |
params.required | stringTransloadit API key used to authenticate requests |
params. | stringReturn ticks scheduled before this UTC ISO timestamp. Omit it for the newest page; use the response’s Validation pattern (regular expression)^(([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 | integerUnique, random value included in signed request params to make each signature unique and prevent accidental signature reuse. |
Request parameters by authentication method
With signed params
Include your Auth Key as params.auth.key. When signing the request, include a future params.auth.expires timestamp and send the signature in the separate signature field. The field definitions below use paths inside params.
Complete JSON Schema
params: Only the fields listed for this object are accepted.
Uses the field definitions above: params.auth, params.before, params.nonce
With a bearer token
Send the bearer token in the Authorization header. You can omit params.auth and the separate signature field. Other required parameters still apply. The field definitions below use paths inside params.
Complete JSON Schema
params: Only the fields listed for this object are accepted.
Uses the field definitions above: params.before, params.nonce
| Field | Type and description |
|---|---|
params. | Contains the Transloadit API key and signature-authentication metadata for a Template request.
|
params. | stringISO 8601 expiration timestamp in the future. Required when a request is signed or requires signature authentication; bearer-authenticated requests may omit it. |
params. | stringTransloadit API key used to authenticate requests |
Response
Here’s an example response body:
{
"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"
}2xx success
JSON response body. application/json text/plain; charset=utf-8
Response body schema
Complete JSON Schema
The response contains only the fields listed for this object.
| Field | Type and description | ||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
messagerequired | string (minimum length: 1) | ||||||||||||||||||||||||||||||||
next_beforerequired | string | nullValidation pattern (regular expression)^(([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)$ | ||||||||||||||||||||||||||||||||
okrequired | string (always: "TEMPLATE_FOUND") | ||||||||||||||||||||||||||||||||
runsrequired | Array<object> (maximum items: 100)Array item schema
| ||||||||||||||||||||||||||||||||
template_idrequired | string |
Error response
JSON response body. application/json text/plain; charset=utf-8
Response body schema
Complete JSON Schema
The response may contain additional fields.
| Field | Type and description |
|---|---|
assembly_id | string |
error | string (minimum length: 1) |
http_code | number | string
|
message | stringHuman-readable explanation of the error. Its wording can vary; use the |
reason | null | string | number | boolean | Array<any value> | objectAny of the following schemas may apply: nullstringnumberbooleanArray<any value>Array<any value>Array item schemaany valueobjectobjectAdditional property schemaany value |
HTTP 400
JSON response body. application/json text/plain; charset=utf-8
Response body schema
Complete JSON Schema
Named errors and the general error format
error: "SIGNATURE_REUSE_DETECTED"
The request was denied for security reasons. If you think this is in error, please get in touch with support.
The response may contain additional fields.
General error format
error: "TEMPLATE_VALIDATION_ERROR"
Your Template didn’t pass validation.
The response may contain additional fields.