GEgetorchestra
Operations

List operations

Changed on

Retrieve a paginated list of task operations 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>

Use operation filters to narrow results by operation type, integration, external ID, operation status, or task run ID.

get/operations

Request

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

operation_typestring

Filter by operation type. Comma-separated values are supported.

integration'AIRBYTE_CLOUD' | 'AIRBYTE_SERVER' | 'AIRFLOW' | 'ARCH' | 'ALTERYX_SERVER' | 'ANTHROPIC' | 'AWS_EC2' | 'AWS_ECS' | 'AWS_EMR' | 'AWS_EKS' | 'AWS_FIREHOSE' | 'AWS_GLUE' | 'AWS_LAMBDA' | 'AWS_RDS' | 'AWS_REDSHIFT' | 'AWS_S3' | 'AWS_BATCH' | 'AWS_BEDROCK' | 'AWS_SAGEMAKER' | 'AWS_SECRETS_MANAGER' | 'AWS_SES' | 'AWS_STEP_FUNCTIONS' | 'AZURE' | 'AZURE_CONTAINER_APPS' | 'AZURE_DATA_FACTORY' | 'AZURE_DATA_LAKE_STORAGE' | 'AZURE_KEY_VAULT' | 'AZURE_KUBERNETES_SERVICE' | 'AZURE_LOGIC_APPS' | 'AZURE_SYNAPSE_ANALYTICS' | 'AZURE_VM' | 'BAUPLAN' | 'BOOMI' | 'CDATA' | 'CENSUS' | 'CLICKHOUSE' | 'COALESCE' | 'COUNT' | 'DATADOG' | 'DATABRICKS' | 'DATAPROC' | 'DATAZEN' | 'DBT' | 'DBT_CORE' | 'DLT' | 'DOMO' | 'DREMIO' | 'DUCKDB' | 'EMAIL' | 'ESTUARY' | 'ETLEAP' | 'FABRIC' | 'FABRIC_SYNAPSE' | 'FIVETRAN' | 'FORTRA' | 'GCP_BIG_QUERY' | 'GCP_CLOUD_RUN' | 'GCP_CLOUD_FUNCTIONS' | 'GCP_CLOUD_STORAGE' | 'GCP_DATAFLOW' | 'GCP_DATAFORM' | 'GCP_DATASTREAM' | 'GCP_LOOKER' | 'GKE' | 'GITHUB_ACTIONS' | 'GOOGLE_CLOUD' | 'HEVO' | 'HEX' | 'HIGHTOUCH' | 'HTTP' | 'HUBSPOT' | 'INFORMATICA_IICS' | 'INFORMATICA_POWERCENTER' | 'KAFKA' | 'KEBOOLA' | 'KLEENE' | 'LIGHTDASH' | 'LINUX_SSH' | 'MARIADB' | 'MATILLION' | 'MATILLION_ETL' | 'METAPLANE' | 'MICROSOFT_TEAMS' | 'MICROSTRATEGY' | 'MONGODB' | 'MOTHERDUCK' | 'MYSQL' | 'N8N' | 'NIMBLE' | 'NOTION' | 'OMNI' | 'OPEN_AI' | 'ORCHESTRA' | 'PARADIME' | 'PAGER_DUTY' | 'PINECONE' | 'PORTABLE' | 'POSTGRES' | 'POWER_AUTOMATE' | 'POWER_BI' | 'PREFECT_CLOUD' | 'PYTHON' | 'QLIK' | 'QLIK_REPLICATE' | 'QUICKBOOKS' | 'RENDER' | 'RIVERY' | 'RUDDERSTACK' | 'SALESFORCE' | 'SAP' | 'SFTP' | 'SHAREPOINT' | 'SIGMA' | 'SISENSE' | 'SLACK' | 'SNOWFLAKE' | 'SNOWPLOW' | 'SODA' | 'SQL_MESH' | 'SQL_SERVER' | 'STITCH' | 'STREAMKAP' | 'TABLEAU_CLOUD' | 'TALEND_CLOUD' | 'THOUGHTSPOT' | 'TOBIKO_CLOUD' | 'TYPESAFE' | 'WEAVIATE' | 'WEBHOOK' | 'WELD' | 'WINDOWS_SSH'

Integration identifier.

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.

external_idstring nullable

External system identifier to filter by.

status'CANCELLED' | 'FAILED' | 'REUSED' | 'SKIPPED' | 'SUCCEEDED' | 'UNKNOWN' | 'WARNING'

Filter by status.

task_run_idstring uuid4 nullable

Task run ID.

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

      removed the enum value CLAUDE from the property anyOf[subschema #1: IntegrationsEnum]/ of the query request parameter integration

    • warning

      added the new ANTHROPIC enum value to the /// response property for the response 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 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 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 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 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 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 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 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 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 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 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 QUICKBOOKS 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 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 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 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

    • 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 enum value ANTHROPIC to the property anyOf[subschema #1: IntegrationsEnum]/ of the query request parameter integration

    • info

      added the enum value AWS_BATCH to the property anyOf[subschema #1: IntegrationsEnum]/ of the query request parameter integration

    • info

      added the enum value AWS_SES to the property anyOf[subschema #1: IntegrationsEnum]/ of the query request parameter integration

    • info

      added the enum value AWS_STEP_FUNCTIONS to the property anyOf[subschema #1: IntegrationsEnum]/ of the query request parameter integration

    • info

      added the enum value DREMIO to the property anyOf[subschema #1: IntegrationsEnum]/ of the query request parameter integration

    • info

      added the enum value HUBSPOT to the property anyOf[subschema #1: IntegrationsEnum]/ of the query request parameter integration

    • info

      added the enum value MARIADB to the property anyOf[subschema #1: IntegrationsEnum]/ of the query request parameter integration

    • info

      added the enum value MONGODB to the property anyOf[subschema #1: IntegrationsEnum]/ of the query request parameter integration

    • info

      added the enum value MYSQL to the property anyOf[subschema #1: IntegrationsEnum]/ of the query request parameter integration

    • info

      added the enum value N8N to the property anyOf[subschema #1: IntegrationsEnum]/ of the query request parameter integration

    • info

      added the enum value NOTION to the property anyOf[subschema #1: IntegrationsEnum]/ of the query request parameter integration

    • info

      added the enum value QUICKBOOKS to the property anyOf[subschema #1: IntegrationsEnum]/ of the query request parameter integration

    • info

      added the enum value SALESFORCE to the property anyOf[subschema #1: IntegrationsEnum]/ of the query request parameter integration

    • info

      added the enum value SHAREPOINT to the property anyOf[subschema #1: IntegrationsEnum]/ of the query request parameter integration

    • info

      added the enum value TYPESAFE to the property anyOf[subschema #1: IntegrationsEnum]/ of the query request parameter integration

    • 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

      removed the CLAUDE enum value from 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