Skip to main content
Trigger.dev logo
  • Category: developer tools
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 10
  • Triggers: 0
  • Slug: TRIGGER_DEV
  • Version: 20261030_00

Tools

Slug: TRIGGER_DEV_BATCH_TRIGGER_TASKStart multiple runs of one deployed Trigger.dev task in one provider-side batch and return the batch and run IDs.

Input Parameters

array
required
Between 1 and 1000 runs to create; each item may include payload, context, and options.
string
required
Identifier of the deployed task to run for every item.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIGGER_DEV_EXECUTE_TRQL_QUERYRun one read-only Trigger.dev Query Language SELECT statement for custom run analytics and return JSON rows or CSV text.

Input Parameters

string
required
TRQL SELECT query to execute against Trigger.dev analytics data.
string ("environment" | "project" | "organization")
Data boundary for the query; the connected key still limits accessible data.
string ("json" | "csv")
Return typed JSON rows or CSV text.
string
Trigger.dev relative time period for the query.
string
End of the query time window as an ISO 8601 date-time.
string
Start of the query time window as an ISO 8601 date-time.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIGGER_DEV_GET_BATCHRetrieve a task batch’s status, run IDs, completion counts, and item errors.

Input Parameters

string
required
Batch ID returned by a batch trigger; sent as batchId in the path.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIGGER_DEV_GET_BATCH_RESULTSRetrieve the success or failure outcome and encoded output for every run in a completed task batch.

Input Parameters

string
required
Batch ID returned by a batch trigger.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIGGER_DEV_GET_ERRORRetrieve one Trigger.dev error group’s message, occurrence history, affected versions, and resolution or ignore state.

Input Parameters

string
required
Error-group ID returned by the error list; sent as errorId in the path.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIGGER_DEV_GET_RUNRetrieve one run’s status, timing, payload, output, attempts, metadata, relationships, schedule, and cost details. Presigned payload or output URLs are returned without fetching their content.

Input Parameters

string
required
Run ID returned by a trigger or run-list response; sent as runId in the path.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIGGER_DEV_GET_RUN_RESULTRetrieve one run’s compact success or failure result, including its encoded output or error and usage duration.

Input Parameters

string
required
Run ID whose terminal result is needed; sent as runId in the path.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIGGER_DEV_LIST_ERRORSReturn one forward page of Trigger.dev error groups, optionally filtered by task, version, status, text, or time window.

Input Parameters

string
Trigger.dev relative time period filter.
Text to search for in error groups.
string
Only include errors seen at or before this ISO 8601 date-time.
array
Error-group statuses to include.
array
Deployment versions whose errors should be returned.
string
Only include errors seen at or after this ISO 8601 date-time.
integer
Number of error groups requested for this page; sent as page[size].
string
Opaque next_cursor from a previous response. Omit for the first page; pass it back unchanged to fetch the next page.
array
Task identifiers whose errors should be returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIGGER_DEV_LIST_RUNSReturn one forward page of runs in the connected environment, optionally filtered by time, status, task, version, tags, schedule, bulk action, test mode, or error.

Input Parameters

array
Run tags to match.
string
Error-group ID whose runs should be returned.
boolean
When set, include only test runs or only non-test runs.
array
Run statuses to include.
array
Deployment versions to include.
integer
Number of runs requested for this page; sent as page[size].
string
Only return runs created at or before this ISO 8601 date-time.
string
Opaque next_cursor from a previous response. Omit for the first page; pass it back unchanged to fetch the next page.
string
Only return runs created by this schedule.
string
Only return runs created at or after this ISO 8601 date-time.
string
Only return runs associated with this Trigger.dev bulk-action ID.
string
Trigger.dev relative time period for run creation.
array
Task identifiers to include.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: TRIGGER_DEV_TRIGGER_TASKStart one run of a deployed Trigger.dev task and return the new run ID.

Input Parameters

string
Optional JSON-compatible context made available to the task run.
object
Optional queueing, deduplication, timing, tagging, and machine settings.
string
JSON-compatible input payload for the task.
string
required
Identifier of the deployed task to run.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not