---
title: "List upgrade steps"
method: GET
path: "/organization/{organization_id}/upgrade-pipeline/steps"
tags: ["Upgrade_pipeline"]
---

# List upgrade steps

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

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

List upgrade steps in the organization.

## Path parameters

- `organization_id` string, required

## Query parameters

- `cursor` string
- `limit` integer
- `source_project_name` string
- `source_service_name` string
- `destination_project_name` string
- `destination_service_name` string

## Response `200`

Response

- UpgradePipelineStepListResponse — UpgradePipelineStepListResponse
  - `first` string — First page
  - `last` string — Last page
  - `next` string — Next page
  - `prev` string — Previous page
  - `steps` object[], required — Steps
    - `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
  - `total_count` integer — Total number of results

## Other responses

- `404` — Organization not found

---

[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/versions/ecaeabf1da31/schema)