Yandex Cloud
Search
Contact UsGet started
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • AI for business
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Yandex Serverless Integrations
  • Comparison with other Yandex Cloud services
  • Pricing policy
  • Terraform reference
    • API authentication
      • Overview
        • Overview
        • Start
        • Stop
        • Terminate
        • Get
        • GetHistory
        • List
  • Monitoring metrics
  • Public materials
  • Release notes

In this article:

  • HTTP request
  • Path parameters
  • Response
  • ExecutionPreview
  • HistoryEntry
  • HistoryEntryInput
  • HistoryEntryOutput
  • HistoryEntryError
  1. Workflows API reference
  2. REST
  3. Execution
  4. GetHistory

Workflows Service, REST: Execution.GetHistory

Written by
Yandex Cloud
Updated at August 8, 2025
  • HTTP request
  • Path parameters
  • Response
  • ExecutionPreview
  • HistoryEntry
  • HistoryEntryInput
  • HistoryEntryOutput
  • HistoryEntryError

Retrieves detailed history of specified Workflow execution.

HTTP requestHTTP request

GET https://serverless-workflows.api.cloud.yandex.net/workflows/v1/execution/{executionId}/history

Path parametersPath parameters

Field

Description

executionId

string

Required field. ID of the Workflow execution.

ResponseResponse

HTTP Code: 200 - OK

{
  "execution": {
    "id": "string",
    "workflowId": "string",
    "status": "string",
    "startedAt": "string",
    "duration": "string"
  },
  "entries": [
    {
      "id": "string",
      "title": "string",
      "description": "string",
      "startedAt": "string",
      "duration": "string",
      "input": {
        // Includes only one of the fields `inputJson`
        "inputJson": "string"
        // end of the list of possible fields
      },
      "output": {
        // Includes only one of the fields `outputJson`
        "outputJson": "string"
        // end of the list of possible fields
      },
      "error": {
        "message": "string",
        "errorCode": "string"
      },
      "status": "string",
      "type": "string",
      "attempts": "string",
      "lastError": {
        "message": "string",
        "errorCode": "string"
      }
    }
  ]
}

Field

Description

execution

ExecutionPreview

Workflow execution details.

entries[]

HistoryEntry

Workflow execution detailed history items.

ExecutionPreviewExecutionPreview

Field

Description

id

string

ID of the Workflow execution. Generated at creation time.

workflowId

string

ID of the Workflow.

status

enum (Status)

Status of the Workflow execution

  • STATUS_UNSPECIFIED
  • QUEUED: Workflow execution is being queued.
  • RUNNING: Workflow execution is running.
  • PAUSED: Workflow execution is being paused.
  • STOPPED: Workflow execution is stopped.
  • FAILED: Workflow execution is failed.
  • FINISHED: Workflow execution is finished.

startedAt

string (date-time)

Start timestamp for the Workflow execution.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

duration

string (duration)

Duration of the Workflow execution.

HistoryEntryHistoryEntry

Field

Description

id

string

ID of the Workflow step.

title

string

Title of the Workflow step.

description

string

Description of the Workflow step.

startedAt

string (date-time)

Start timestamp for the Workflow step.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

duration

string (duration)

Duration of the Workflow step.

input

HistoryEntryInput

Input data for the Workflow step.

output

HistoryEntryOutput

Result of the Workflow step.

error

HistoryEntryError

Error details, in case Workflow step failed.

status

enum (Status)

Status of the Workflow step.

  • STATUS_UNSPECIFIED
  • SCHEDULED: Step execution is being scheduled.
  • STARTED: Step execution is started.
  • COMPLETED: Step execution is completed.
  • FAILED: Step execution is failed.
  • CANCEL_REQUESTED: Step execution is requested to be cancelled.
  • CANCELLED: Step execution is canceled.

type

string

Type of the Workflow step (for example, FunctionCall or HttpCall).

attempts

string (int64)

Number of attempts (including all retries of unsuccessful attempts). Value "1" means there were no retries.

lastError

HistoryEntryError

Last received error details in case of retries.

HistoryEntryInputHistoryEntryInput

Field

Description

inputJson

string

JSON input data for the Workflow step.

Includes only one of the fields inputJson.

HistoryEntryOutputHistoryEntryOutput

Field

Description

outputJson

string

JSON result for the Workflow step.

Includes only one of the fields outputJson.

HistoryEntryErrorHistoryEntryError

Field

Description

message

string

Error message of the Workflow step.

errorCode

string

Error code of the Workflow step.

Was the article helpful?

Previous
Get
Next
List
© 2025 Direct Cursus Technology L.L.C.