Get a Workflow Execution Status

curl --request GET \
  --url https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions/{executionId} \
  --header 'Authorization: Bearer <token>'

package main

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

func main() {

	url := "https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions/{executionId}"

	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))

}

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions/{executionId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions/{executionId}"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

{
  "completedAt": "2026-03-17T14:35:12Z",
  "currentStepNumber": 1,
  "errorMessage": "<string>",
  "executionId": "f7e6d5c4-b3a2-1098-7654-321fedcba098",
  "startedAt": "2026-03-17T14:35:00Z",
  "status": "completed",
  "totalSteps": 1,
  "workflowId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

Get a Workflow Execution Status

Returns the current status of one execution of the workflow named in the path: its state (pending, running, completed, failed), the step it is on, and when it started and finished. Call it after executing the workflow, with the executionId that call returned, to follow the execution until it reaches completed or failed; then read its output with the results operation of the same path. Read-only: nothing changes. The body is the same as GET /v1/executions/; this operation additionally requires the execution to belong to the workflow in the path, so it is the one to use with a credential confined to some workflows. Errors: 400 FLK-0002 when workflowId or executionId is not a UUID; 404 FLK-0500 when no execution with this id belongs to that workflow — an execution of another workflow is answered exactly as one that does not exist; 403 when the credential may not read executions of that workflow.

GET

workflows

{workflowId}

executions

{executionId}

Get a Workflow Execution Status

curl --request GET \
  --url https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions/{executionId} \
  --header 'Authorization: Bearer <token>'

package main

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

func main() {

	url := "https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions/{executionId}"

	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))

}

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions/{executionId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://flowker.sandbox.lerian.net/v1/workflows/{workflowId}/executions/{executionId}"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

{
  "completedAt": "2026-03-17T14:35:12Z",
  "currentStepNumber": 1,
  "errorMessage": "<string>",
  "executionId": "f7e6d5c4-b3a2-1098-7654-321fedcba098",
  "startedAt": "2026-03-17T14:35:00Z",
  "status": "completed",
  "totalSteps": 1,
  "workflowId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

{
  "code": "FLK-0001",
  "detail": "name is a required field",
  "errors": [
    {
      "location": "body.nodes",
      "message": "expected array length >= 1",
      "value": "<unknown>"
    }
  ],
  "instance": "/v1/workflows",
  "status": 400,
  "title": "Bad Request",
  "type": "https://errors.lerian.studio/v1/FLK-0001"
}

Authorizations

Authorization

string

header

required

JWT bearer token issued by the identity provider. Send it in the Authorization header as Bearer <token>.

Path Parameters

workflowId

string<uuid>

required

Identifier (UUID) of the workflow the execution belongs to.

executionId

string<uuid>

required

Execution identifier (UUID), as returned when the workflow was executed.

Response

Indicates that the request was successful and the response contains the requested data.

completedAt

string<date-time>

Timestamp when the execution finished. Null if still running.

Example:

"2026-03-17T14:35:12Z"

currentStepNumber

integer

Number of the step currently being executed (1-indexed).

Example:

1

errorMessage

string

Error message if the execution failed. Null on success.

executionId

string<uuid>

Unique identifier of the execution.

Example:

"f7e6d5c4-b3a2-1098-7654-321fedcba098"

startedAt

string<date-time>

Timestamp when the execution started.

Example:

"2026-03-17T14:35:00Z"

status

enum<string>

Current status: pending (queued), running (in progress), completed (success), or failed (error).

Available options:

pending,

running,

completed,

failed

Example:

"completed"

totalSteps

integer

Total number of steps in the workflow.

Example:

1

workflowId

string<uuid>

ID of the workflow being executed.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

Catalog API

Workflows API

Schedule API

Executions API

Dashboards API

Executor Configurations API

Provider Configurations API

Schema Registry API

OpenAPI Schemas API

XSD Schemas API

Webhooks API

Error handling

Get a Workflow Execution Status

Authorizations

Path Parameters

Response