Skip to main content
Retrieve the full execution log and step-by-step details for a specific workflow run.

Overview

The Execution Detail endpoint returns the complete trace of a single workflow execution, including every step that ran, its inputs, outputs, duration, and any errors encountered. Use this to debug failures, verify output data, and understand execution flow.

Authentication

Requires a valid API key. No special permission scope is needed beyond a valid key.

Key Features

  • Step-Level Detail: Inputs, outputs, and timing for every step
  • Error Tracing: Pinpoint exactly which step failed and why
  • Full Execution Context: Trigger data, step outputs, and final result
  • No Credit Cost: This endpoint is free to use
curl -X GET "https://api.trigify.io/v1/workflows/wf_abc123/executions/run_x7k9m2" \
  -H "x-api-key: YOUR_API_KEY"

Path Parameters

ParameterTypeDescription
idstringThe unique workflow ID
runIdstringThe unique execution run ID

Example Response

{
  "success": true,
  "data": {
    "id": "exec_abc123",
    "run_id": "run_x7k9m2",
    "workflow_id": "wf_abc123",
    "status": "completed",
    "started_at": "2026-03-27T10:15:00.000Z",
    "ended_at": "2026-03-27T10:15:04.320Z",
    "duration_ms": 4320,
    "event_name": "workflows/new-post",
    "created": "2026-03-27T10:15:00.000Z",
    "column_config": [
      {
        "id": "col_summary",
        "stepId": "agent-1",
        "fieldPath": "result.output",
        "label": "Summary"
      }
    ],
    "steps": [
      {
        "step_id": "agent-1",
        "step_name": "Summarise Post",
        "operation": "generic_agent",
        "status": "completed",
        "started_at": "2026-03-27T10:15:00.100Z",
        "ended_at": "2026-03-27T10:15:02.450Z",
        "duration_ms": 2350,
        "input": {
          "prompt": "Summarise this post"
        },
        "output": {
          "result": {
            "output": "The author announced a new AI platform and highlighted recent product momentum."
          }
        },
        "mapped_output": {
          "Summary": "The author announced a new AI platform and highlighted recent product momentum."
        },
        "error": null
      }
    ],
    "error": null
  }
}

Response Fields

Execution

FieldTypeDescription
idstringExecution log identifier
run_idstringUnique execution identifier
workflow_idstringParent workflow identifier
statusstringExecution status: running, completed, or failed
started_atstringISO 8601 timestamp when the execution started
ended_atstring | nullISO 8601 timestamp when the execution finished
duration_msinteger | nullTotal execution duration in milliseconds
event_namestringTrigger event name used for the run
createdstringISO 8601 timestamp when the log row was created
column_configarray | nullOptional table-column mappings applied to step outputs
stepsarrayOrdered list of step execution details
errorstring | nullTop-level error message if the execution failed

Step Detail

Each step in the steps array includes:
FieldTypeDescription
step_idstringWorkflow step identifier
step_namestring | nullHuman-readable step name
operationstringAction kind identifier
statusstringStep status: pending, running, completed, failed, or skipped
started_atstringISO 8601 timestamp when the step started
ended_atstring | nullISO 8601 timestamp when the step finished
duration_msinteger | nullStep duration in milliseconds
inputobjectResolved input values passed to the action
outputobject | nullOutput values produced by the action
mapped_outputobject | nullOptional flattened values produced from column_config mappings
errorstring | object | nullError details if the step failed

Credit Usage

This endpoint is free and does not consume credits.