# updateRecurringBillingSubscriptionPlan

Mutation · GraphQL API

Updates an existing recurring billing subscription plan's metadata or default billing settings.

## Authentication

- SERVER

## Input

- `input` (`UpdateRecurringBillingSubscriptionPlanInput!`) — required

## Returns [RecurringBillingSubscriptionPlanPayload](/braintree/graphql/reference/types/recurring-billing-subscription-plan-payload)

The response object returned after a recurring billing subscription plan mutation.

### Returned fields

- `clientMutationId` (`String`): An identifier used to reconcile requests and responses. 255 characters maximum.
- `plan` (`RecurringBillingSubscriptionPlan`): The plan that was created or updated.

## Examples

### Update recurring billing subscription plan

Top-level input fields for updating a recurring billing subscription plan.

```graphql
mutation updateRecurringBillingSubscriptionPlan($input: UpdateRecurringBillingSubscriptionPlanInput!) {
  updateRecurringBillingSubscriptionPlan(input: $input) {
    clientMutationId
    plan {
      __typename
      id
      legacyId
      name
      description
      price {
        value
        currencyCode
      }
      billingFrequency
      billingDayOfMonth
      numberOfBillingCycles
      trial {
        duration
        durationUnit
      }
      addOns {
        __typename
        id
        legacyId
      }
      discounts {
        __typename
        id
        legacyId
      }
      createdAt
      updatedAt
    }
  }
}
```

---

[View the complete GraphQL schema on GitHub](https://raw.githubusercontent.com/braintree/graphql-api/refs/heads/master/schema.graphql)