> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Trigger.dev

> Trigger.dev is a platform for building, deploying, and managing reliable background tasks and workflows.

![Trigger.dev logo](https://mintcdn.com/composio-preview/IA0_SoMcsWt17HEC/images/toolkits/trigger_dev.svg?fit=max\&auto=format\&n=IA0_SoMcsWt17HEC\&q=85\&s=2f73b75bc6f46e72e7d0c0234ede32ac)

* **Category:** developer tools
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 10
* **Triggers:** 0
* **Slug:** `TRIGGER_DEV`
* **Version:** 20261030\_00

## Tools

> [accordion] Batch Trigger Task
>
> **Slug:** `TRIGGER_DEV_BATCH_TRIGGER_TASK`
>
> Start multiple runs of one deployed Trigger.dev task in one provider-side batch and return the batch and run IDs.
>
> #### Input Parameters
>
> **items** `array` *required*
>
> Between 1 and 1000 runs to create; each item may include payload, context, and options.
>
> **task\_identifier** `string` *required*
>
> Identifier of the deployed task to run for every item.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Execute TRQL Query
>
> **Slug:** `TRIGGER_DEV_EXECUTE_TRQL_QUERY`
>
> Run one read-only Trigger.dev Query Language SELECT statement for custom run analytics and return JSON rows or CSV text.
>
> #### Input Parameters
>
> **query** `string` *required*
>
> TRQL SELECT query to execute against Trigger.dev analytics data.
>
> **scope** `string ("environment" | "project" | "organization")`
>
> Data boundary for the query; the connected key still limits accessible data.
>
> **format** `string ("json" | "csv")`
>
> Return typed JSON rows or CSV text.
>
> **period** `string`
>
> Trigger.dev relative time period for the query.
>
> **to\_time** `string`
>
> End of the query time window as an ISO 8601 date-time.
>
> **from\_time** `string`
>
> Start of the query time window as an ISO 8601 date-time.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Batch
>
> **Slug:** `TRIGGER_DEV_GET_BATCH`
>
> Retrieve a task batch's status, run IDs, completion counts, and item errors.
>
> #### Input Parameters
>
> **batch\_id** `string` *required*
>
> Batch ID returned by a batch trigger; sent as batchId in the path.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Batch Results
>
> **Slug:** `TRIGGER_DEV_GET_BATCH_RESULTS`
>
> Retrieve the success or failure outcome and encoded output for every run in a completed task batch.
>
> #### Input Parameters
>
> **batch\_id** `string` *required*
>
> Batch ID returned by a batch trigger.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Error
>
> **Slug:** `TRIGGER_DEV_GET_ERROR`
>
> Retrieve one Trigger.dev error group's message, occurrence history, affected versions, and resolution or ignore state.
>
> #### Input Parameters
>
> **error\_id** `string` *required*
>
> Error-group ID returned by the error list; sent as errorId in the path.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Run
>
> **Slug:** `TRIGGER_DEV_GET_RUN`
>
> Retrieve 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
>
> **run\_id** `string` *required*
>
> Run ID returned by a trigger or run-list response; sent as runId in the path.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Run Result
>
> **Slug:** `TRIGGER_DEV_GET_RUN_RESULT`
>
> Retrieve one run's compact success or failure result, including its encoded output or error and usage duration.
>
> #### Input Parameters
>
> **run\_id** `string` *required*
>
> Run ID whose terminal result is needed; sent as runId in the path.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Errors
>
> **Slug:** `TRIGGER_DEV_LIST_ERRORS`
>
> Return one forward page of Trigger.dev error groups, optionally filtered by task, version, status, text, or time window.
>
> #### Input Parameters
>
> **period** `string`
>
> Trigger.dev relative time period filter.
>
> **search** `string`
>
> Text to search for in error groups.
>
> **to\_time** `string`
>
> Only include errors seen at or before this ISO 8601 date-time.
>
> **statuses** `array`
>
> Error-group statuses to include.
>
> **versions** `array`
>
> Deployment versions whose errors should be returned.
>
> **from\_time** `string`
>
> Only include errors seen at or after this ISO 8601 date-time.
>
> **page\_size** `integer`
>
> Number of error groups requested for this page; sent as page\[size].
>
> **next\_cursor** `string`
>
> Opaque next\_cursor from a previous response. Omit for the first page; pass it back unchanged to fetch the next page.
>
> **task\_identifiers** `array`
>
> Task identifiers whose errors should be returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Runs
>
> **Slug:** `TRIGGER_DEV_LIST_RUNS`
>
> Return 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
>
> **tags** `array`
>
> Run tags to match.
>
> **error** `string`
>
> Error-group ID whose runs should be returned.
>
> **is\_test** `boolean`
>
> When set, include only test runs or only non-test runs.
>
> **statuses** `array`
>
> Run statuses to include.
>
> **versions** `array`
>
> Deployment versions to include.
>
> **page\_size** `integer`
>
> Number of runs requested for this page; sent as page\[size].
>
> **created\_to** `string`
>
> Only return runs created at or before this ISO 8601 date-time.
>
> **next\_cursor** `string`
>
> Opaque next\_cursor from a previous response. Omit for the first page; pass it back unchanged to fetch the next page.
>
> **schedule\_id** `string`
>
> Only return runs created by this schedule.
>
> **created\_from** `string`
>
> Only return runs created at or after this ISO 8601 date-time.
>
> **bulk\_action\_id** `string`
>
> Only return runs associated with this Trigger.dev bulk-action ID.
>
> **created\_period** `string`
>
> Trigger.dev relative time period for run creation.
>
> **task\_identifiers** `array`
>
> Task identifiers to include.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Trigger Task
>
> **Slug:** `TRIGGER_DEV_TRIGGER_TASK`
>
> Start one run of a deployed Trigger.dev task and return the new run ID.
>
> #### Input Parameters
>
> **context** `string`
>
> Optional JSON-compatible context made available to the task run.
>
> **options** `object`
>
> Optional queueing, deduplication, timing, tagging, and machine settings.
>
> **payload** `string`
>
> JSON-compatible input payload for the task.
>
> **task\_identifier** `string` *required*
>
> Identifier of the deployed task to run.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
