GEgetorchestra
Task Runs

List task runs

Changed on

Retrieve a paginated list of task runs for the workspace the credential resolves to.

<Note> `time_from` and `time_to` are optional. If neither is provided, the API returns the last 24 hours of data. If both are provided, the maximum time range per request is 7 days. `time_from` cannot be earlier than 2023-01-01.

From 2026-10-01 the default changed from the last 7 days to the last 24 hours. Pass time_from and time_to explicitly to control the window. </Note>

Filter by multiple statuses, integrations, pipeline IDs, or task run IDs using comma-separated values. For example, status=SUCCEEDED,FAILED&integration=HTTP,SNOWFLAKE returns task runs matching either status and either integration.

get/task_runs

Request

  • Base URL
    https://app.getorchestra.io/api/engine/public
  • URL
    https://app.getorchestra.io/api/engine/public/task_runs
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://app.getorchestra.io/oauth/authorize
      Token URL: https://app.getorchestra.io/oauth/token scopes: orchestra:read

Query parameters

pageinteger

Page number. Must be greater than or equal to 1.

page_sizeinteger

Number of items per page. Defaults to 50; maximum 100.

time_fromstring date-time nullable

Start of the time window as an ISO 8601 datetime.

time_tostring date-time nullable

End of the time window as an ISO 8601 datetime.

pipeline_idsstring

Filter by pipeline IDs. Provide comma-separated UUIDs for multiple values.

statusstring

Filter by status. Comma-separated values are supported where the parameter accepts multiple values.

integrationstring

Integration identifier.

task_run_idsstring

Filter by task run IDs. Provide comma-separated UUIDs for multiple values.

include_supersededboolean

Include superseded task runs, which are the earlier attempts of a task that was retried. Set to false to return only the latest attempt of each task.

Headers

X-Orchestra-Account-Idstring uuid4 nullable

Act on this account rather than the one the credential resolves to. Omit it to use the credential's own account. An API key is issued to a single account, so it may only name that account; an OAuth token may name any account its grant covers.

Response

Successful response.

pageinteger required
pageSizeinteger required
totalinteger required

Changes

  • daf2c16b3057Revision changes
    • warning

      added the new LIGHTDASH_CLEAR_RESULTS_CACHE enum value to the // response property for the response status

  • e45165e7e223Revision changes
    • breaking

      added to the ///// response property oneOf list for the response status

    • warning

      removed the optional property // from the response with the status

    • warning

      added the new ANTHROPIC enum value to the // response property for the response status

    • warning

      added the new ANTHROPIC_CLAUDE_CHAT enum value to the // response property for the response status

    • warning

      added the new AWS_BATCH enum value to the // response property for the response status

    • warning

      added the new AWS_BATCH_SUBMIT_JOB enum value to the // response property for the response status

    • warning

      added the new AWS_S3_GET_FILE enum value to the // response property for the response status

    • warning

      added the new AWS_S3_PUT_FILE enum value to the // response property for the response status

    • warning

      added the new AWS_SES enum value to the // response property for the response status

    • warning

      added the new AWS_SES_SEND_EMAIL enum value to the // response property for the response status

    • warning

      added the new AWS_STEP_FUNCTIONS enum value to the // response property for the response status

    • warning

      added the new AWS_STEP_FUNCTIONS_START_EXECUTION enum value to the // response property for the response status

    • warning

      added the new DREMIO enum value to the // response property for the response status

    • warning

      added the new DREMIO_RUN_QUERY enum value to the // response property for the response status

    • warning

      added the new GCP_CLOUD_STORAGE_GET_FILE enum value to the // response property for the response status

    • warning

      added the new GCP_CLOUD_STORAGE_PUT_FILE enum value to the // response property for the response status

    • warning

      added the new HUBSPOT enum value to the // response property for the response status

    • warning

      added the new HUBSPOT_IMPORT_RECORDS enum value to the // response property for the response status

    • warning

      added the new LIGHTDASH_REFRESH_PRE_AGGREGATE enum value to the // response property for the response status

    • warning

      added the new MARIADB enum value to the // response property for the response status

    • warning

      added the new MARIADB_RUN_QUERY enum value to the // response property for the response status

    • warning

      added the new MONGODB enum value to the // response property for the response status

    • warning

      added the new MONGODB_RUN_COMMAND enum value to the // response property for the response status

    • warning

      added the new MONGODB_RUN_TEST enum value to the // response property for the response status

    • warning

      added the new MYSQL enum value to the // response property for the response status

    • warning

      added the new MYSQL_RUN_QUERY enum value to the // response property for the response status

    • warning

      added the new N8N enum value to the // response property for the response status

    • warning

      added the new N8N_RUN_WORKFLOW enum value to the // response property for the response status

    • warning

      added the new NOTION enum value to the // response property for the response status

    • warning

      added the new NOTION_APPEND_BLOCKS enum value to the // response property for the response status

    • warning

      added the new NOTION_CREATE_DATABASE_PAGE enum value to the // response property for the response status

    • warning

      added the new NOTION_CREATE_PAGE enum value to the // response property for the response status

    • warning

      added the new NOTION_UPDATE_DATABASE_PAGE enum value to the // response property for the response status

    • warning

      added the new PAUSED enum value to the // response property for the response status

    • warning

      added the new QUICKBOOKS enum value to the // response property for the response status

    • warning

      added the new QUICKBOOKS_CREATE_ENTITY enum value to the // response property for the response status

    • warning

      added the new RUDDERSTACK_RETL_SYNC enum value to the // response property for the response status

    • warning

      added the new SALESFORCE enum value to the // response property for the response status

    • warning

      added the new SALESFORCE_RUN_ANALYTICS_DATAFLOW enum value to the // response property for the response status

    • warning

      added the new SFTP_GET_FILE enum value to the // response property for the response status

    • warning

      added the new SFTP_PUT_FILE enum value to the // response property for the response status

    • warning

      added the new SHAREPOINT enum value to the // response property for the response status

    • warning

      added the new SHAREPOINT_GET_FILE enum value to the // response property for the response status

    • warning

      added the new SHAREPOINT_PUT_FILE enum value to the // response property for the response status

    • warning

      added the new TYPESAFE enum value to the // response property for the response status

    • warning

      added the new TYPESAFE_JEV_EVALUATE enum value to the // response property for the response status

    • warning

      added the new operation_duration_above_baseline enum value to the ///// response property for the response status

    • warning

      added the new operation_duration_below_baseline enum value to the ///// response property for the response status

    • warning

      added the new pipeline_duration_below_baseline enum value to the ///// response property for the response status

    • warning

      added the new task_duration_below_baseline enum value to the ///// response property for the response status

    • info

      the endpoint scheme security BearerAuthReadOnly was removed from the API

    • info

      added the new optional header request parameter X-Orchestra-Account-Id

    • info

      added the new optional query request parameter include_superseded

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added operation_duration_above_baseline operation_duration_below_baseline pipeline_duration_above_baseline pipeline_duration_below_baseline task_duration_above_baseline task_duration_below_baseline discriminator mapping keys to the ///// response property for the response status

    • info

      removed the CLAUDE enum value from the // response property for the response status

    • info

      removed the CLAUDE_CHAT enum value from the // response property for the response status