GET
/
workflow-executions
/
{execution_id}
{
  "id": "<string>",
  "run_id": "<string>",
  "start_time": "2023-11-07T05:31:56Z",
  "execution_time": "2023-11-07T05:31:56Z",
  "close_time": "2023-11-07T05:31:56Z",
  "status": "RUNNING",
  "workflow_type": "<string>",
  "task_queue": "<string>",
  "history_length": 123,
  "parent_wf_exec_id": "<string>",
  "events": [
    {
      "event_id": 123,
      "event_time": "2023-11-07T05:31:56Z",
      "event_type": "WORKFLOW_EXECUTION_STARTED",
      "task_id": 123,
      "event_group": {
        "event_id": 123,
        "udf_namespace": "<string>",
        "udf_name": "<string>",
        "udf_key": "<string>",
        "action_id": "<string>",
        "action_ref": "<string>",
        "action_title": "<string>",
        "action_description": "<string>",
        "action_input": {
          "task": {
            "ref": "<string>",
            "description": "<string>",
            "action": "<string>",
            "args": {},
            "depends_on": [
              "<string>"
            ],
            "run_if": "<string>",
            "for_each": "<string>",
            "retry_policy": {
              "max_attempts": 123,
              "timeout": 123,
              "retry_until": "<string>"
            },
            "start_delay": 123,
            "wait_until": "<string>",
            "join_strategy": "any"
          },
          "exec_context": {},
          "run_context": {
            "wf_id": "<string>",
            "wf_exec_id": "<string>",
            "wf_run_id": "<string>",
            "environment": "<string>"
          }
        },
        "action_result": "<any>",
        "current_attempt": 123,
        "retry_policy": {
          "max_attempts": 123,
          "timeout": 123,
          "retry_until": "<string>"
        },
        "start_delay": 0,
        "join_strategy": "any",
        "related_wf_exec_id": "<string>"
      },
      "failure": {
        "message": "<string>",
        "cause": {}
      },
      "result": "<any>",
      "role": {
        "type": "user",
        "workspace_id": "<string>",
        "user_id": "<string>",
        "access_level": 0,
        "service_id": "tracecat-runner"
      },
      "parent_wf_exec_id": "<string>",
      "workflow_timeout": 123
    }
  ]
}

Authorizations

fastapiusersauth
string
cookie
required

Path Parameters

execution_id
string
required

Query Parameters

workspace_id
string
required

Response

200
application/json
Successful Response
id
string
required

The ID of the workflow execution

run_id
string
required

The run ID of the workflow execution

start_time
string
required

The start time of the workflow execution

status
enum<string>
required
Available options:
RUNNING,
COMPLETED,
FAILED,
CANCELED,
TERMINATED,
CONTINUED_AS_NEW,
TIMED_OUT
workflow_type
string
required
task_queue
string
required
history_length
integer
required

Number of events in the history

events
object[]
required

The events in the workflow execution

execution_time
string | null

When this workflow run started or should start.

close_time
string | null

When the workflow was closed if closed.

parent_wf_exec_id
string | null