from engini import Engini
client = Engini() # reads ENGINI_API_KEY
# one page; list_page also returns next_cursor and total_count
page = client.executions.list_page(workflow_id=123, status=["failed"], top=20)
for run in page.items:
print(run.execution_id, run.status)import { Engini } from "@engini/sdk";
const client = new Engini(); // reads ENGINI_API_KEY
// one page; listPage also returns nextCursor and totalCount
const page = await client.executions.listPage({ workflowId: 123, status: ["failed"], top: 20 });
for (const run of page.items ?? []) console.log(run.executionId, run.status);engini executions list --workflow 123 --status failed --top 20const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.engini.io/v1/executions', 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://api.engini.io/v1/executions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://api.engini.io/v1/executions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.engini.io/v1/executions")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.engini.io/v1/executions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"items": [
{
"executionId": 123,
"workflowId": 123,
"type": "<string>",
"triggerType": "<string>",
"status": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"activitiesRan": 123,
"dataTransferred": 123,
"dataAvailable": true,
"workspace": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
},
"environment": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"type": "<string>"
},
"startedAt": "2023-11-07T05:31:56Z",
"closedAt": "2023-11-07T05:31:56Z",
"duration": 123,
"context": "<string>",
"createdBy": {
"id": 123,
"name": "<string>"
}
}
],
"offset": 123,
"top": 123,
"totalCount": 123,
"nextCursor": "<string>"
}{
"errorCode": "<string>",
"message": "<string>",
"requestId": "<string>",
"timestamp": "<string>",
"details": [
{
"field": "<string>",
"issue": "<string>"
}
]
}{
"errorCode": "<string>",
"message": "<string>",
"requestId": "<string>",
"timestamp": "<string>",
"details": [
{
"field": "<string>",
"issue": "<string>"
}
]
}{
"errorCode": "<string>",
"message": "<string>",
"requestId": "<string>",
"timestamp": "<string>",
"details": [
{
"field": "<string>",
"issue": "<string>"
}
]
}{
"errorCode": "<string>",
"message": "<string>",
"requestId": "<string>",
"timestamp": "<string>",
"details": [
{
"field": "<string>",
"issue": "<string>"
}
]
}{
"errorCode": "<string>",
"message": "<string>",
"requestId": "<string>",
"timestamp": "<string>",
"details": [
{
"field": "<string>",
"issue": "<string>"
}
]
}{
"errorCode": "<string>",
"message": "<string>",
"requestId": "<string>",
"timestamp": "<string>",
"details": [
{
"field": "<string>",
"issue": "<string>"
}
]
}List executions
Returns executions of workflows, table automations and app business rules, newest first. A workspace-scoped key lists the executions of its own workspace and environment; an account-wide key lists the account’s. Use type to filter the category and triggerType to filter how it was triggered. Only real runs appear: the audit rows recorded when a workflow is edited or toggled are not executions.
With no explicit createdAfter or createdBefore, the query is limited to the last 30 days. Executions whose per-step detail has passed the workflow’s retention window are still listed, with dataAvailable false, so a wide window never shows unexplained gaps.
For paging through a lot of data prefer cursor over offset: executions are inserted continuously, and offset paging over a table growing underneath you repeats and skips rows. Follow nextCursor until it is absent. A cursor is tied to the sort it was issued for, and is not offered when sorting by closedAt, which is unset on open executions. Cursor pages omit totalCount.
from engini import Engini
client = Engini() # reads ENGINI_API_KEY
# one page; list_page also returns next_cursor and total_count
page = client.executions.list_page(workflow_id=123, status=["failed"], top=20)
for run in page.items:
print(run.execution_id, run.status)import { Engini } from "@engini/sdk";
const client = new Engini(); // reads ENGINI_API_KEY
// one page; listPage also returns nextCursor and totalCount
const page = await client.executions.listPage({ workflowId: 123, status: ["failed"], top: 20 });
for (const run of page.items ?? []) console.log(run.executionId, run.status);engini executions list --workflow 123 --status failed --top 20const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.engini.io/v1/executions', 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://api.engini.io/v1/executions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://api.engini.io/v1/executions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.engini.io/v1/executions")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.engini.io/v1/executions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"items": [
{
"executionId": 123,
"workflowId": 123,
"type": "<string>",
"triggerType": "<string>",
"status": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"activitiesRan": 123,
"dataTransferred": 123,
"dataAvailable": true,
"workspace": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
},
"environment": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"type": "<string>"
},
"startedAt": "2023-11-07T05:31:56Z",
"closedAt": "2023-11-07T05:31:56Z",
"duration": 123,
"context": "<string>",
"createdBy": {
"id": 123,
"name": "<string>"
}
}
],
"offset": 123,
"top": 123,
"totalCount": 123,
"nextCursor": "<string>"
}{
"errorCode": "<string>",
"message": "<string>",
"requestId": "<string>",
"timestamp": "<string>",
"details": [
{
"field": "<string>",
"issue": "<string>"
}
]
}{
"errorCode": "<string>",
"message": "<string>",
"requestId": "<string>",
"timestamp": "<string>",
"details": [
{
"field": "<string>",
"issue": "<string>"
}
]
}{
"errorCode": "<string>",
"message": "<string>",
"requestId": "<string>",
"timestamp": "<string>",
"details": [
{
"field": "<string>",
"issue": "<string>"
}
]
}{
"errorCode": "<string>",
"message": "<string>",
"requestId": "<string>",
"timestamp": "<string>",
"details": [
{
"field": "<string>",
"issue": "<string>"
}
]
}{
"errorCode": "<string>",
"message": "<string>",
"requestId": "<string>",
"timestamp": "<string>",
"details": [
{
"field": "<string>",
"issue": "<string>"
}
]
}{
"errorCode": "<string>",
"message": "<string>",
"requestId": "<string>",
"timestamp": "<string>",
"details": [
{
"field": "<string>",
"issue": "<string>"
}
]
}Query Parameters
Optional trigger filter, for example instant, scheduled or recordUpdate.
instant, automated, scheduled, buttonClicked, recordCreate, recordUpdate, recordDelete, barcodeInput, fieldChanged, dropDownClicked, screenOnLoad, onRecordClicked, onAddRecordClicked, iFrameEvent, api, mCPTool, workflowMCPTool, webhookSubscribe, webhookUnsubscribe, onWebhookReceived, onWebhookSubscription, chatBot, workflowActivityTool, onGetDynamicList, onRefreshObjectList, onRefreshObject, onSaveSelectedObjects, onActivityExecute, onBeforeRequest Optional sort over createdAt, executionId, closedAt. Comma-separated keys, each "field asc" or "field desc", highest priority first - e.g. "closedAt desc,createdAt asc". At most 3 keys; a field may appear once; every key needs an explicit direction when there is more than one; nothing may follow executionId. A single key may omit the direction and then sorts descending. Defaults to createdAt desc. Cursor paging is only available for a single createdAt or executionId key.
Response
A paginated list of executions.
Paginated wrapper for an endpoint that supports both offset and cursor paging.