# Upgrade a Subscription

**POST /v1/customers/{customerId}/subscriptions/{subscriptionId}/upgrade**

Upgrades the specified subscription. This process is asynchronous, therefore it will start executing after the request is submitted and may take some time.


## Servers
- https://api.cloudcockpit.com: https://api.cloudcockpit.com ()


## Authentication methods
- Bearer auth


## Parameters
### Headers
- **X-Tenant** (string)
  The domain used to access the portal.
- **Authorization** (string)
  JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"
- **X-Correlation-Id** (string(uuid))
  This header is optional and by setting it you can correlate the audit logs made by this request.

### Path parameters
- **customerId** (string(uuid))
  GUID Unique identifier for the customer. The subscription must belong to this customer, otherwise this request will fail.
- **subscriptionId** (string(uuid))
  GUID Unique identifier for the subscription.


### Body: application/json (object)
The subscription transition info to upgrade the existent subscription.
- **destinationSubscriptionId** (string(uuid) | null)
  The destination subscription identifier.
- **destinationProviderSubscriptionId** (string | null)
  The destination subscription provider identifer.
- **offerName** (string | null)
  The name of the offer.
- **offerId** (string(uuid))
  The name of the offer.
- **providerOfferId** (string | null)
  The provider offer identifier.
- **providerOfferIdWithAvailability** (string | null)
  The provider offer identifier.
- **imageUrl** (string | null)
  The offer image URL.
- **quantity** (integer(int32))
  The quantity.
- **termDuration** (object)
  The term duration for this entity. Possible values: NoTerm, OneMonth, OneYear, ThreeYears or FiveYears
- **billingFrequency** (object)
  The billing frequency for this entity. Possible values: OneTime, Monthly, Annual, Triennial or None
- **transitionType** (string | null)
  The type of transition ('transition_only','transition_with_license_transfer').
- **transitionEvents** (array[object] | null)
  A list with the events related to a transition.


## Responses
### 202
Accepted

### 400
Bad Request

#### Body: application/json (object)
- **statusCode** (integer(int32))
  The HTTP status code that represents a specific error scenario.
- **type** (string | null)
  The type of error that occurred.
- **description** (string | null)
  Describes the error scenario that occurred.
- **correlationId** (string | null)
  The correlationId of the request that originated the error.
- **errors** (array[object] | null)
  A list containing the detail of the errors that occurred in this error scenario.

### 401
Unauthorized

### 403
Forbidden

### 409
Conflict

#### Body: application/json (object)
- **portalSubscription** (object)
  The viewmodel for checking subscription conflict.
- **providerSubscription** (object)
  The viewmodel for checking subscription conflict.

### 404
Not Found

#### Body: application/json (object)
- **statusCode** (integer(int32))
  The HTTP status code that represents a specific error scenario.
- **type** (string | null)
  The type of error that occurred.
- **description** (string | null)
  Describes the error scenario that occurred.
- **correlationId** (string | null)
  The correlationId of the request that originated the error.
- **errors** (array[object] | null)
  A list containing the detail of the errors that occurred in this error scenario.

### 500
Internal Server Error

#### Body: application/json (object)
- **statusCode** (integer(int32))
  The HTTP status code that represents a specific error scenario.
- **type** (string | null)
  The type of error that occurred.
- **description** (string | null)
  Describes the error scenario that occurred.
- **correlationId** (string | null)
  The correlationId of the request that originated the error.
- **errors** (array[object] | null)
  A list containing the detail of the errors that occurred in this error scenario.


[Powered by Bump.sh](https://bump.sh)