---
title: "Update a stage"
method: PUT
path: "/stages/{stage_id}"
tags: ["Management"]
---

# Update a stage

`PUT /stages/{stage_id}`

Update stage settings

## Path parameters

- `stage_id` integer, required

## Request body

- Stage
  - `id` integer
  - `name` string, required
  - `branch_id` integer
  - `branch_name` string
  - `schema` object
    - `parent` string
    - `triggers` object
      - `parent` boolean
    - `parameters` object[]
      - `name` string
      - `default` string
  - `schema_code` string
  - `enabled` boolean

## Response `201`

Successfully created run

## Changes

- **2021-02-06** `8416f5ec71bb` — 1 breaking
  - request body became required
- **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/stages/:stage_id/put.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)