Assigning roles for a workflow
Written by
Updated at January 12, 2026
CLI
API
If you do not have the Yandex Cloud CLI installed yet, install and initialize it.
By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific command using the --folder-name or --folder-id parameter.
Run the following command to assign a role for a workflow:
-
To a user:
yc serverless workflow add-access-binding <workflow_name_or_ID> \ --user-account-id <user_ID> \ --role <role> -
To a service account:
yc serverless workflow add-access-binding <workflow_name_or_ID> \ --service-account-id <service_account_ID> \ --role <role> -
To all authenticated users (the
All authenticated userspublic group):yc serverless workflow add-access-binding <workflow_name_or_ID> \ --all-authenticated-users \ --role <role>
Example
Assigning a role for a workflow to a service account:
yc serverless workflow add-access-binding epdplu8jn7sr******** \
--service-account-id rrbilgiqaptv******** \
--role serverless.workflows.auditor
Result:
...1s...done (3s)
Use the setAccessBinding REST API method for the Workflow resource or the WorkflowService/SetAccessBinding gRPC API call.