---
title: "Create an upgrade step"
method: POST
path: "/organization/{organization_id}/upgrade-pipeline/steps"
tags: ["Upgrade_pipeline"]
---

# Create an upgrade step

`POST /organization/{organization_id}/upgrade-pipeline/steps`

> This endpoint **may be changed or removed at any time**. Don't use it in production environments.

Customer must have write access to both source and destination projects (read-only is not enough). Both services must belong to the organization in the URL (and thus the same organization). Initial validation is seeded based on the destination service type pinned release.

## Path parameters

- `organization_id` string, required

## Request body

- UpgradePipelineStepCreateRequestBody — UpgradePipelineStepCreateRequestBody
  - `auto_validation_delay_days` integer — Days before automatic validation (defaults to 7)
  - `destination_project_name` string, required — Destination project name
  - `destination_service_name` string, required — Destination service name
  - `source_project_name` string, required — Source project name
  - `source_service_name` string, required — Source service name

## Response `200`

Response

- UpgradePipelineStepCreateResponse — UpgradePipelineStepCreateResponse
  - `auto_validation_delay_days` integer, required — Days before automatic validation
  - `destination_project_name` string, required — Destination project name
  - `destination_service_name` string, required — Destination service name
  - `last_validation` object, required — Last validation information for an upgrade step.
    - `comment` string, required — Validation comment
    - `validated_at` string, required — When the validation was created
    - `validated_by_user` string, required — User who created the validation (null for auto-validation)
  - `source_project_name` string, required — Source project name
  - `source_service_name` string, required — Source service name
  - `step_id` string, required — Step ID

## Other responses

- `403` — Upgrade pipeline is not enabled for the destination project
- `404` — Project not found
- `409` — Destination already has a source

---

[API](https://skmtc.net/aiven/apis/aiven-api-documentation.md) · [All operations](https://skmtc.net/aiven/apis/aiven-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aiven/aiven-api-documentation/revisions/cbfbf0f96a48/schema)