---
title: Modify the billing grace period opt-in status and duration
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/patch-v1-subscriptiongraceperiods-_id_
---

# Modify the billing grace period opt-in status and duration

Change the Boolean value representing the billing grace period opt-in status.

## URL

PATCH https://api.appstoreconnect.apple.com/v1/subscriptionGracePeriods/{id}

## Path Parameters

id:

## Response Codes

200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 409 Conflict: 422 : 429 :

## Mentioned in

Managing auto-renewable subscriptions

## Discussion

Discussion Example Request and Response

## HTTP Body

There are now new duration options that can be set by using SubscriptionGracePeriodDuration

## See Also

### Endpoints

- [Read the billing grace period value for an app](appstoreconnectapi/get-v1-apps-_id_-subscriptiongraceperiod.md)
- [Get the subscription grace period ID for an app](appstoreconnectapi/get-v1-apps-_id_-relationships-subscriptiongraceperiod.md)
- [Read the billing grace period value](appstoreconnectapi/get-v1-subscriptiongraceperiods-_id_.md)