---
title: "IBCSoftwareUpgrade defines a rpc handler method for MsgIBCSoftwareUpgrade."
method: POST
path: "/ibc.core.client.v1.Msg/IBCSoftwareUpgrade"
tags: ["Msg"]
---

# IBCSoftwareUpgrade defines a rpc handler method for MsgIBCSoftwareUpgrade.

`POST /ibc.core.client.v1.Msg/IBCSoftwareUpgrade`

## Request body

- IbcCoreClientV1MsgIBCSoftwareUpgrade
  - `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
  - `signer` string
  - `upgraded_client_state` GoogleProtobufAny
    - `@type` string

## Response `200`

A successful response.

- IbcCoreClientV1MsgIBCSoftwareUpgradeResponse — MsgIBCSoftwareUpgradeResponse defines the Msg/IBCSoftwareUpgrade response type.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2024-08-14** `21c607e4fa20` — 1 info
  - api operation id `IbcCoreClientV1Msg_IBCSoftwareUpgrade` removed and replaced with `FeeMsg_IBCSoftwareUpgrade`
- **2024-02-23** `54713b4a9d25` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pokt-network/apis/http-api-console/changes/ibc.core.client.v1.Msg/IBCSoftwareUpgrade/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)