Skip to main content
GET
/
api
/
tasks
/
runs
Get task runs
curl --request GET \
  --url https://api.recoupable.com/api/tasks/runs \
  --header 'x-api-key: <api-key>'
{
  "runs": [
    {
      "id": "<string>",
      "taskIdentifier": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "idempotencyKey": "<string>",
      "version": "<string>",
      "isTest": true,
      "startedAt": "2023-11-07T05:31:56Z",
      "finishedAt": "2023-11-07T05:31:56Z",
      "delayedUntil": "2023-11-07T05:31:56Z",
      "ttl": "<unknown>",
      "expiredAt": "2023-11-07T05:31:56Z",
      "tags": [
        "<string>"
      ],
      "metadata": {},
      "costInCents": 123,
      "baseCostInCents": 123,
      "durationMs": 123,
      "env": {
        "id": "<string>",
        "name": "<string>",
        "user": "<string>"
      },
      "depth": 123,
      "batchId": "<string>",
      "payload": "<unknown>",
      "output": {
        "videoSourceUrl": "<string>",
        "imageUrl": "<string>",
        "captionText": "<string>",
        "template": "artist-caption-bedroom",
        "lipsync": true,
        "audio": {
          "songTitle": "<string>",
          "songFilename": "<string>",
          "startSeconds": 123,
          "durationSeconds": 123,
          "clipLyrics": "<string>",
          "clipMood": "<string>"
        }
      },
      "error": {
        "message": "<string>",
        "name": "<string>",
        "stackTrace": "<string>"
      },
      "attempts": [
        {
          "id": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "startedAt": "2023-11-07T05:31:56Z",
          "completedAt": "2023-11-07T05:31:56Z",
          "error": {
            "message": "<string>",
            "name": "<string>",
            "stackTrace": "<string>"
          }
        }
      ],
      "schedule": {},
      "relatedRuns": {}
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developers.recoupable.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Your Recoup API key. Learn more.

Query Parameters

​
runId
string

The unique identifier of a specific task run to retrieve. If omitted, returns a list of recent runs for the authenticated account.

​
limit
integer
default:20

Maximum number of runs to return when listing (ignored when runId is provided). Default 20, max 100.

Required range: 1 <= x <= 100
​
account_id
string<uuid>

Filter runs by account ID. When provided, returns runs tagged with account:<account_id>. Only applicable when the authenticated account has access to multiple accounts via organization membership.

Response

Task runs retrieved successfully.

​
status
enum<string>
required

Indicates the request was successful

Available options:
success
​
runs
object[]
required

List of recent task runs for the authenticated account. Each item is a raw Trigger.dev SDK run object (same shape as TaskRunResponse, but without output and error fields).