---
title: "Create a stage"
method: PUT
path: "/pipelines/{pipelineKey}/stages"
---

# Create a stage

`PUT /pipelines/{pipelineKey}/stages`

## Request

- Base URL: `https://api.streak.com/api/v1`
- URL: `https://api.streak.com/api/v1/pipelines/{pipelineKey}/stages`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/streakyc/apis/streak-v1-url-encoded/docs/pipelines/:pipelineKey/stages/put.ts> (a function with typed inputs; its response is checked against the schema)

This call lets you create a [stage](reference#get-a-stage) defined in a [pipeline](reference#getting-a-specific-pipeline).

## Path parameters

- `pipelineKey` string, required

## Request body `application/x-www-form-urlencoded`

- object
  - `name` string, required: The name of the stage you'd like to add to the pipeline

## Response `200`

200

- object
  - `name` string
  - `key` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `467f4c2b40e3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/streakyc/apis/streak-v1-url-encoded/changes/pipelines/:pipelineKey/stages/put.md)

---

[API](https://skmtc.dev/streakyc/apis/streak-v1-url-encoded.md) - [All operations](https://skmtc.dev/streakyc/apis/streak-v1-url-encoded/llms.txt) - [OpenAPI document](https://skmtc.dev/streakyc/apis/streak-v1-url-encoded/revisions/467f4c2b40e3?raw)