---
title: "Create a run"
method: POST
path: "/flows/{flow_id}/runs"
tags: ["Execution"]
---

# Create a run

`POST /flows/{flow_id}/runs`

Create a new run

## Path parameters

- `flow_id` integer, required

## Request body

- Run
  - `id` integer
  - `label` string
  - `project_id` integer
  - `project_name` string
  - `branch_id` integer
  - `branch_name` string
  - `flow_id` integer
  - `flow_kind` string
  - `flow_label` string
  - `stage_id` integer
  - `stage_name` string
  - `args` object
  - `created` string, date-time
  - `started` string, date-time
  - `duration` string
  - `state` string
  - `jobs_error` integer
  - `jobs_rerun` integer
  - `jobs_waiting` integer
  - `jobs_executing` integer
  - `jobs_processing` integer
  - `jobs_total` integer
  - `tests_not_run` integer
  - `tests_passed` integer
  - `tests_total` integer
  - `issues_total` integer
  - `issues_new` integer
  - `artifacts_total` integer
  - `report_entries` ReportEntry[]
    - `name` string
    - `url` string
  - `fix_cnt` integer
  - `regr_cnt` integer
  - `repo_data` object
  - `reason` string

## Response `201`

Successfully created run

## Changes

- **2022-01-30** `05cdffedf0db` — 1 info
  - added the new optional request property `flow_label`
- **2021-07-22** `dc4b682358d1` — 1 info
  - added the new optional request property `report_entries`
- **2021-01-31** `ecd12e02213d` — 1 info
  - added optional request body
- **2021-01-31** `6dffc3a4de00` — 1 breaking
  - removed the request body

[Change history](https://skmtc.dev/kraken-ci/apis/server-api/changes/flows/:flow_id/runs/post.md)

---

[API](https://skmtc.dev/kraken-ci/apis/server-api.md) · [All operations](https://skmtc.dev/kraken-ci/apis/server-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kraken-ci/server-api/revisions/1f2ae877f985/schema)