# Update Subscription

```
PUT 
/subscriptions/:id
```

Updates the configuration of an existing subscription.

**Modifiable Parameters**:

* Billing information (amount, description, allowedPaymentMethods)
* Customer details (contact information, billing/shipping addresses)
* Subscription settings (cancelAtPeriodEnd, pauseAtPeriodEnd, skipIntervalCount)
* Metadata (for your internal tracking)

**Update Effects**:

* Amount changes apply to the next billing cycle
* Customer information updates take effect immediately
* Setting `cancelAtPeriodEnd` to true will end the subscription after the current period
* Setting `pauseAtPeriodEnd` to true will pause billing after the current period
* Setting `skipIntervalCount` skips billing for the specified number of intervals without changing subscription status

**Note**: Some fundamental properties cannot be changed once a subscription is created, including currency and billing interval. To modify these, you would need to cancel the existing subscription and create a new one.

## Request[​](#request "Direct link to request")

## Responses[​](#responses "Direct link to Responses")

* 200
* 400
* 401
* 404
* 422
* 500
* 503

A subscription object

The request is incorrect or could not be processed

Unauthorized error. Please check your auth credentials

The specified resource was not found

The request was well-formed but could not be processed due to semantic errors

Unexpected server error

The service is temporarily unavailable