Skip to main content

Endpoint

GET https://workflows.eachlabs.run/api/v1/executions/{executionID}

Path Parameters

ParameterTypeRequiredDescription
executionIDstringYesExecution UUID

Code Examples

curl https://workflows.eachlabs.run/api/v1/executions/EXEC_ID \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "execution_id": "69ae8c7b-7500-4a45-b7c0-348b8cc2665b",
  "workflow_id": "50741f40-8621-4d46-8a91-dff4d873be98",
  "status": "completed",
  "started_at": "2025-12-04T11:48:10Z",
  "completed_at": "2025-12-04T11:50:53Z",
  "inputs": {
    "prompt": "A majestic mountain landscape"
  },
  "step_outputs": {
    "step1": {
      "step_id": "step1",
      "status": "completed",
      "started_at": "2025-12-04T11:48:10Z",
      "completed_at": "2025-12-04T11:48:39Z",
      "output": "A breathtaking panoramic view...",
      "primary": "A breathtaking panoramic view...",
      "metadata": {
        "model": "openai-chatgpt-5",
        "version": "0.0.1",
        "params": {
          "system_prompt": "You are a helpful assistant",
          "user_prompt": "A majestic mountain landscape",
          "max_output_tokens": 512
        }
      }
    },
    "step2": {
      "step_id": "step2",
      "status": "completed",
      "started_at": "2025-12-04T11:48:39Z",
      "completed_at": "2025-12-04T11:50:53Z",
      "output": ["https://storage.googleapis.com/uploads/image1.png"],
      "primary": "https://storage.googleapis.com/uploads/image1.png",
      "metadata": {
        "model": "flux-1-1-pro",
        "version": "0.0.1"
      }
    }
  },
  "output": ["https://storage.googleapis.com/uploads/image1.png"]
}

Response Fields

FieldTypeDescription
execution_idstringExecution UUID
workflow_idstringWorkflow UUID
bulk_idstring | nullBulk operation ID (if triggered via bulk-trigger)
statusstringrunning, completed, failed, or cancelled
started_atstringStart timestamp
completed_atstring | nullCompletion timestamp
inputsobjectInput parameters used
step_outputsobjectMap of step ID → StepOutput
outputany | nullFinal workflow output (only when completed)
errorstring | nullError type (only when failed)
error_causestring | nullDetailed error message (only when failed)

Execution Statuses

StatusDescription
runningWorkflow is executing
completedAll steps finished successfully
failedA step encountered an error
cancelledExecution was cancelled

Error Responses

StatusBodyDescription
401{"error": "Invalid or missing API key"}Authentication failure
404{"error": "execution not found"}Invalid execution ID
Last modified on March 3, 2026