---
title: "Update subscription price"
method: PATCH
path: "/users/me/subscription-price"
---

# Update subscription price

`PATCH /users/me/subscription-price`

Set the authenticated creator's monthly subscription price, in USD cents (minor units).

**⚠️ Side effect when increasing the price:** all existing active subscribers are moved to a pending opt-in state for the new price. With `forceOptIn: false` (default) they keep auto-renewing at their current price until they accept the new one; with `forceOptIn: true` they are forced to opt in at the new price and their current auto-renewal is disabled. The response's `subscribersMovedToReOptIn` reports whether this happened. Decreasing the price has no effect on existing subscribers.

The new price must stay compatible with the creator's promotions: if any promotion's discount would take it below the platform minimum, the request is rejected until that promotion is deleted.

## Headers

- `X-Fanvue-API-Version` string, required

## Request body

- object
  - `subscriptionPrice` integer, required — New monthly subscription price in USD cents (minor units), between 399 and 10000
  - `forceOptIn` boolean — Only used when the price increases. When false (default), existing subscribers keep auto-renewing at their current price until they opt in to the new one. When true, they are forced to opt in at the new price and their current auto-renewal is disabled.

## Response `200`

Subscription price updated successfully

- object
  - `subscriptionPrice` integer, required — The subscription price now in effect, in USD cents (minor units)
  - `subscribersMovedToReOptIn` boolean, required — True when the price increase moved existing active subscribers to a pending re-opt-in state (see the endpoint description)

## Other responses

- `400` — Invalid price, not a creator account, or conflicting active promotion
- `401` — Unauthorized Response
- `403` — Unauthorized Response
- `410` — API version no longer supported (sunset)
- `429` — Too many requests - rate limit exceeded

---

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