GEgetorchestra
Task Runs

List task runs for a pipeline run

Changed on

Retrieve task runs belonging to a single pipeline run. This endpoint uses page_size default 10 and maximum 50.

get/pipeline_runs/{pipeline_run_id}/task_runs

Request

  • Base URL
    https://app.getorchestra.io/api/engine/public
  • URL
    https://app.getorchestra.io/api/engine/public/pipeline_runs/{pipeline_run_id}/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

Path parameters

pipeline_run_idstring uuid4 required

Pipeline run ID.

Query parameters

page_sizeinteger

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

pageinteger

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

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