Yandex Cloud
Search
Contact UsTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
  • Marketplace
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • 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
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2026 Direct Cursus Technology L.L.C.
Yandex Serverless Integrations
  • Comparing 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:

  • gRPC request
  • StartExecutionRequest
  • ExecutionInput
  • Value
  • ListValue
  • StartExecutionResponse
  1. Workflows API reference
  2. gRPC
  3. Execution
  4. Start

Workflows Service, gRPC: ExecutionService.Start

Written by
Yandex Cloud
Updated at February 26, 2026
  • gRPC request
  • StartExecutionRequest
  • ExecutionInput
  • Value
  • ListValue
  • StartExecutionResponse

Starts new Workflow execution.

gRPC requestgRPC request

rpc Start (StartExecutionRequest) returns (StartExecutionResponse)

StartExecutionRequestStartExecutionRequest

{
  "workflow_id": "string",
  "input": {
    // Includes only one of the fields `input_json`, `input_value`
    "input_json": "string",
    "input_value": {
      // Includes only one of the fields `nullValue`, `numberValue`, `stringValue`, `boolValue`, `structValue`, `listValue`
      "nullValue": "NullValue",
      "numberValue": "double",
      "stringValue": "string",
      "boolValue": "bool",
      "structValue": "google.protobuf.Struct",
      "listValue": {
        "values": [
          "Value"
        ]
      }
      // end of the list of possible fields
    }
    // end of the list of possible fields
  }
}

Field

Description

workflow_id

string

Required field. ID of the Workflow.

input

ExecutionInput

Input for the Workflow execution

ExecutionInputExecutionInput

Field

Description

input_json

string

JSON input data for the Workflow execution.

Includes only one of the fields input_json, input_value.

input_value

Value

Input value for the Workflow execution.

Includes only one of the fields input_json, input_value.

ValueValue

Field

Description

nullValue

enum NullValue

Includes only one of the fields nullValue, numberValue, stringValue, boolValue, structValue, listValue.

numberValue

double

Includes only one of the fields nullValue, numberValue, stringValue, boolValue, structValue, listValue.

stringValue

string

Includes only one of the fields nullValue, numberValue, stringValue, boolValue, structValue, listValue.

boolValue

bool

Includes only one of the fields nullValue, numberValue, stringValue, boolValue, structValue, listValue.

structValue

google.protobuf.Struct

Includes only one of the fields nullValue, numberValue, stringValue, boolValue, structValue, listValue.

listValue

ListValue

Includes only one of the fields nullValue, numberValue, stringValue, boolValue, structValue, listValue.

ListValueListValue

Field

Description

values[]

Value

StartExecutionResponseStartExecutionResponse

{
  "execution_id": "string"
}

Field

Description

execution_id

string

ID of the Workflow execution.

Was the article helpful?

Previous
Overview
Next
Stop
© 2026 Direct Cursus Technology L.L.C.