Migrate a workflow's open tasks to one of its versions
POST/api/v1/workflows/:workflow_id/migrations
Moves every open task of the workflow that runs on an older version, or on none, onto to_version. Each task is migrated as migrate-task migrates one and needs tasks:MigrateTask on it; a task it would refuse is reported as refused with the error, and the run goes on. The tasks and the caller's permission on each are fixed when the run is recorded. A state_map target the version lacks, or a terminal one, refuses the request before any task moves. Runs in the background by default (status: queued); wait: true answers once every task has settled. See Migrating every open task.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 413
- 429
- 500
- 502
- 4XX
The run, queued in the background or completed with wait: true
The version does not exist, or a state_map target is undeclared or terminal
Unauthorized
Forbidden
Workflow not found
REQUEST_REJECTED — the request body is over the size the body parser accepts
QUOTA_EXCEEDED — a requests quota on the calling API key or its project is spent for the window; Retry-After says when it reopens
Response Headers
Seconds until the quota window admits a request again
Unexpected server error — INTERNAL_ERROR, with the raw message never forwarded
The deployment's admission service is asked about this write and did not answer — ADMISSION_UNAVAILABLE; the write did not happen
The deployment's admission service refused this write — answered under the service's own 4xx status, with its code (matching ^[A-Za-z_][A-Za-z0-9_]{0,63}$, not necessarily an ERROR_CODES key), message and meta; the write did not happen. A status this operation also declares on its own is documented there