# deleteRecurringBillingSubscriptionPlan

Mutation · GraphQL API

Deletes a recurring billing subscription plan permanently. After deletion, querying the plan by Node ID will return a NOT_FOUND error.

Note: This mutation is different from canceling a subscription:
- DELETE plan: Removes the plan definition entirely (requires no active, past due, or pending subscriptions)
- CANCEL subscription: Sets individual subscription to CANCELED status (can be reactivated).

## Authentication

- SERVER

## Input

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

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

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

### Returned fields

- `clientMutationId` (`String`): An identifier used to reconcile requests and responses. 255 characters maximum.

## Examples

### Delete recurring billing subscription plan

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

```graphql
mutation deleteRecurringBillingSubscriptionPlan($input: DeleteRecurringBillingSubscriptionPlanInput!) {
  deleteRecurringBillingSubscriptionPlan(input: $input) {
    clientMutationId
  }
}
```

---

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