---
title: "[Beta] Upgrades the project's Postgres version"
method: POST
path: "/v1/projects/{ref}/upgrade"
tags: ["Projects"]
---

# [Beta] Upgrades the project's Postgres version

`POST /v1/projects/{ref}/upgrade`

## Path parameters

- `ref` string, required

## Request body

- UpgradeDatabaseBody
  - `target_version` string, required
  - `release_channel` 'internal' | 'alpha' | 'beta' | 'ga' | 'withdrawn' | 'preview'

## Response `201`

- ProjectUpgradeInitiateResponse
  - `tracking_id` string, required

## Other responses

- `401` — Unauthorized
- `403` — Forbidden action
- `429` — Rate limit exceeded
- `500` — Failed to initiate project upgrade

---

[API](https://skmtc.net/supabase/apis/management-api.md) · [All operations](https://skmtc.net/supabase/apis/management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/supabase/management-api/versions/a7cb39418064/schema)