Update workflow rollout map

Replaces the rollout map for a workflow. Entries must reference published versions and their rollout_percentage values must sum to 100.

Required scope: workflows:write

Authentication

X-API-Keystring

Organization API key. Keys are prefixed with vk_live_ (production) or vk_sandbox_ (sandbox).

Path parameters

workflow_idstringRequired

Headers

Verifa-VersiondateOptional

API version date string (e.g. 2026-02-01). If omitted, the version pinned to your API key is used.

Key-InflectionenumOptionalDefaults to snake

Response key casing. Defaults to snake.

Allowed values:
Idempotency-KeystringOptional<=255 characters

Unique key for idempotent requests. Cached for 24 hours. Sending the same key with different parameters returns 422.

Request

This endpoint expects an object.
rolloutlist of objectsRequired

Response

Updated rollout map.
datalist of objects

Errors

401
Unauthorized Error
404
Not Found Error
422
Unprocessable Entity Error