Discuss with expertTry it for free
© 2026 Direct Cursus Technology L.L.C.

Executing a workflow via a link

Written by
Updated at August 18, 2026
View in Markdown

Note

Currently, there are two UIs that support Workflows: Yandex Cloud and Yandex AI Studio. In this case, the following applies:

  • Workflows created in the Yandex Cloud UI are automatically available in the AI Studio UI.
  • Workflows created in the AI Studio UI are not available in the Yandex Cloud UI.

Starting September 3, 2026, Workflows will no longer be supported in the Yandex Cloud UI. To create and manage workflows, use the AI Studio UI.

Note

You can get a link for workflow execution using the management console only if the workflow is public.

  1. In the management console, select the folder containing the workflow.
  2. Navigate to Serverless Integrations.
  3. In the left-hand panel, click Workflows.
  4. Select a workflow. The execution link will appear in the Start URL field.

To get an execution link, run this command:

yc serverless workflow get <container_name>

The execution link will appear in the execution_url field.

To get a workflow execution link, use the get REST API method for the Workflow resource or the WorkflowsService/Get gRPC API call. The execution link will appear in the execution_url field.

Executing a workflow via HTTPS

If the workflow is:

  • Public, any user can run it.
  • Private, the user needs to get authenticated by providing an IAM token or API key in the Authorization header.

To execute a workflow, send a POST request:

  • Example of public workflow execution without providing the input data:

    curl -X POST "https://serverless-workflows.api.cloud.yandex.net/workflows/v1/execution/fd2g4pu20roc********/start"

  • Example of executing a private workflow without providing the input data and with IAM token authentication:

    IAM_TOKEN="<IAM_token>"
curl -X POST \
--header "Authorization: Bearer $IAM_TOKEN" \
"https://serverless-workflows.api.cloud.yandex.net/workflows/v1/execution/dfq3l36kr2gh********/start"

  • Example of executing a private workflow without providing the input data and with API key authentication:

    API_KEY="<API_key>"
curl -X POST \
--header "Authorization: Api-Key $API_KEY" \
"https://serverless-workflows.api.cloud.yandex.net/workflows/v1/execution/dfq3l36kr2gh********/start"

  • Example of public workflow execution with providing input data (the input data is passed to the workflow input unchanged):

    curl "https://serverless-workflows.api.cloud.yandex.net/workflows/v1/execution/fd2g4pu20roc********/start" -d '{"hello": "world"}'

Useful links

Previous
On a timer
Next
Stopping a workflow execution