---
title: "SoftwareUpgrade is a governance operation for initiating a software upgrade."
method: POST
path: "/cosmos.upgrade.v1beta1.Msg/SoftwareUpgrade"
tags: ["Msg"]
---

# SoftwareUpgrade is a governance operation for initiating a software upgrade.

`POST /cosmos.upgrade.v1beta1.Msg/SoftwareUpgrade`

Since: cosmos-sdk 0.46

## Request body

- CosmosUpgradeV1beta1MsgSoftwareUpgrade — MsgSoftwareUpgrade is the Msg/SoftwareUpgrade request type. Since: cosmos-sdk 0.46
  - `authority` string — authority is the address that controls the module (defaults to x/gov unless overwritten).
  - `plan` CosmosUpgradeV1beta1Plan — Plan specifies information about a planned upgrade and when it should occur.
    - `height` string, int64 — The height at which the upgrade must be performed.
    - `info` string
    - `name` string — Sets the name for the upgrade. This name will be used by the upgraded version of the software to apply any special "on-upgrade" commands during the first BeginBlock method after the upgrade is applied. It is also used to detect whether a software version can handle a given upgrade. If no upgrade handler with this name has been set in the software, it will be assumed that the software is out-of-date when the upgrade Time or Height is reached and the software will exit.
    - `time` string, date-time — Deprecated: Time based upgrades have been deprecated. Time based upgrade logic has been removed from the SDK. If this field is not empty, an error will be thrown.
    - `upgraded_client_state` GoogleProtobufAny
      - `@type` string

## Response `200`

A successful response.

- CosmosUpgradeV1beta1MsgSoftwareUpgradeResponse — MsgSoftwareUpgradeResponse is the Msg/SoftwareUpgrade response type. Since: cosmos-sdk 0.46

## Other responses

- `default` — An unexpected error response.

## Changes

- **2024-08-14** `21c607e4fa20` — 1 info
  - endpoint added
- **2024-07-31** `19416a3f0cd1` — 1 breaking
  - api path removed without deprecation
- **2024-07-11** `ca7e84576c8e` — 1 info
  - endpoint added
- **2024-05-15** `41fb8b09e244` — 1 breaking
  - api path removed without deprecation
- **2024-04-05** `f64b957aa2be` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pokt-network/apis/http-api-console/changes/cosmos.upgrade.v1beta1.Msg/SoftwareUpgrade/post.md)

---

[API](https://skmtc.dev/pokt-network/apis/http-api-console.md) · [All operations](https://skmtc.dev/pokt-network/apis/http-api-console/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pokt-network/http-api-console/revisions/21c607e4fa20/schema)