Get workflow run

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs/{run_id} \
  --header 'api_key: <api-key>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs/{run_id}"

headers = {"api_key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs/{run_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs/{run_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs/{run_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs/{run_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "run_id": "0195f2a1-4c3e-7b21-9f0d-2a5c8e1b4d77",
  "workflow_id": "68b1c0d4e7b91d003c45a1f2",
  "status": "completed",
  "workflow_name": "Email me new signups",
  "trigger_type": "scheduled",
  "started_at": "2026-08-25T09:12:44Z",
  "completed_at": "2026-08-25T09:12:46Z",
  "duration_ms": 1840,
  "steps_count": 3,
  "error_message": "The email step failed because the recipient address was missing.",
  "is_test_run": false,
  "ai_analysis": "The email step failed because the recipient address was missing from the trigger payload.",
  "steps": [
    {
      "completed_at": "2026-08-25T09:12:46Z",
      "duration_ms": 1840,
      "error_message": "",
      "started_at": "2026-08-25T09:12:44Z",
      "status": "completed",
      "task_name": "send_email",
      "task_type": "call"
    }
  ],
  "credits_consumed": 0.5,
  "status_reason": "",
  "definition_version_id": "9f2c1a7b3e5d84f60c1b2a9e7d4f8c3b6a5e2d1f0c9b8a7e6d5c4b3a2f1e0d9c"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Runs

Get workflow run

This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.

Reads one run with its step-by-step log.

steps walks the tasks the run executed in order, each with its status, timing, and error if it failed. definition_version_id names the version the run executed, which can be older than the workflow’s current one.

Each step also carries the data that went into it and came out of it. Those fields are not documented here because their shape is whatever your workflow passes around, but they are in the response.

This endpoint is limited to 120 requests per minute.

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time.

This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.

GET

api

apps

{app_id}

workflows

{workflow_id}

runs

{run_id}

Get workflow run

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs/{run_id} \
  --header 'api_key: <api-key>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs/{run_id}"

headers = {"api_key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs/{run_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs/{run_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs/{run_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/workflows/{workflow_id}/runs/{run_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "run_id": "0195f2a1-4c3e-7b21-9f0d-2a5c8e1b4d77",
  "workflow_id": "68b1c0d4e7b91d003c45a1f2",
  "status": "completed",
  "workflow_name": "Email me new signups",
  "trigger_type": "scheduled",
  "started_at": "2026-08-25T09:12:44Z",
  "completed_at": "2026-08-25T09:12:46Z",
  "duration_ms": 1840,
  "steps_count": 3,
  "error_message": "The email step failed because the recipient address was missing.",
  "is_test_run": false,
  "ai_analysis": "The email step failed because the recipient address was missing from the trigger payload.",
  "steps": [
    {
      "completed_at": "2026-08-25T09:12:46Z",
      "duration_ms": 1840,
      "error_message": "",
      "started_at": "2026-08-25T09:12:44Z",
      "status": "completed",
      "task_name": "send_email",
      "task_type": "call"
    }
  ],
  "credits_consumed": 0.5,
  "status_reason": "",
  "definition_version_id": "9f2c1a7b3e5d84f60c1b2a9e7d4f8c3b6a5e2d1f0c9b8a7e6d5c4b3a2f1e0d9c"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

ID of the app whose workflows you want to work with.

workflow_id

string

required

ID of the workflow, as returned in id by List workflows.

run_id

string

required

ID of the run, as returned in run_id by List runs for a workflow.

Response

The run and its steps.

Single run with step-by-step event log.

run_id

string

required

ID of the run.

Example:

"0195f2a1-4c3e-7b21-9f0d-2a5c8e1b4d77"

workflow_id

string

required

ID of the workflow that ran.

Example:

"68b1c0d4e7b91d003c45a1f2"

status

string

required

How the run is going: running, completed, failed, or cancelled.

Example:

"completed"

workflow_name

string

default:""

Name of that workflow at the time of the run.

Example:

"Email me new signups"

trigger_type

string

default:""

What started the run.

Example:

"scheduled"

started_at

string | null

When the run started, as an ISO 8601 timestamp.

Example:

"2026-08-25T09:12:44Z"

completed_at

string | null

When the run finished. null while it is still running.

Example:

"2026-08-25T09:12:46Z"

duration_ms

integer

default:0

How long the run took, in milliseconds.

Example:

1840

steps_count

integer

default:0

Steps the run executed.

Example:

3

error_message

string | null

Why the run failed. null when it did not fail.

Example:

"The email step failed because the recipient address was missing."

is_test_run

boolean

default:false

true when the run was started by hand rather than by its trigger.

Example:

false

ai_analysis

string | null

Stored failure explanation, once Analyze a failed workflow run has generated one. null until then.

Example:

"The email step failed because the recipient address was missing from the trigger payload."

steps

Steps · object[]

The tasks the run executed, in order. Each carries task_name, task_type, status, started_at, completed_at, duration_ms and error_message, plus the data that went into and came out of the step, whose shape is whatever your workflow passes around.

Example:

[
  {
    "completed_at": "2026-08-25T09:12:46Z",
    "duration_ms": 1840,
    "error_message": "",
    "started_at": "2026-08-25T09:12:44Z",
    "status": "completed",
    "task_name": "send_email",
    "task_type": "call"
  }
]

credits_consumed

number

default:0

Credits the run used.

Example:

0.5

status_reason

string

default:""

Why the run failed or was cancelled. Empty on runs that finished successfully.

Example:

""

definition_version_id

string

default:""

Version the run executed, which can be older than the workflow's current one. Read it with Get workflow version.

Example:

"9f2c1a7b3e5d84f60c1b2a9e7d4f8c3b6a5e2d1f0c9b8a7e6d5c4b3a2f1e0d9c"

⌘I

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Workflows API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

Get workflow run

Authorizations

Path Parameters

Response