Skip to main content

Start task

POST 

/api/tasks/:task_id/start

Starts a task: queues it for dispatch, or starts or reactivates an epic's pipeline; an active task is left unchanged, an awaiting_response task returns 409, and for a non-epic task run_requested runs it past unmet prerequisites and an epic that holds between stages. An operator acting as the organization may pass push_as_id, a project member who may start tasks, to push with that member's git account; a task with a repository and nobody to push as returns 422, and when the project's release pipeline needs approval to start, it returns 202 with state waiting and the task stays in draft until the approval lands; a caller not allowed to take that step gets 403 step_forbidden. without_repo runs the task, or every task in an epic's group, in an empty folder without the project's repository, for a starter who cannot read it (ignored on a project with no repository; 409 while one of them still holds a copy of the repository, or when no node of the project can run a task without it), and fresh_elsewhere gives up a non-epic task's MicroVM to start it again on another node (409 when it has no MicroVM or its project no other node).

Request​

Responses​

OK