{"method":"POST","path":"https://api.revcent.com/v2/subscriptions/{subscription_id}","summary":"Edit A Subscription","description":"Edit a subscription using the subscription ID. This operation is meant for modifying attributes of a subscription, and not the active status of a subscription. Use the web app to modify the product and customize a specific subscriptions' renewal period. View markdown documentation at https://revcent.com/documentation/markdown/mcp/operation/EditSubscription.md for an in-depth overview of this operation.","operationId":"EditSubscription","parameters":[{"in":"path","name":"subscription_id","description":"The subscription ID.","required":true,"schema":{"type":"string","description":"A 20 character subscription ID.","minLength":20,"maxLength":20}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"subscription_profile":{"type":"string","description":"A 20 character subscription profile ID.","minLength":20,"maxLength":20},"coupon":{"description":"An array of coupons to attach to the subscription.","type":"array","items":{"type":"string","description":"A 20 character coupon ID.","minLength":20,"maxLength":20}},"amount":{"description":"The subscription amount.","type":"number"},"next_renewal_date":{"description":"Set the subscriptions' next renewal date","type":"string","format":"date-time"},"ship_to":{"description":"The ship to information for the item.","type":"object","additionalProperties":false,"properties":{"first_name":{"type":"string","description":"The shipping first name."},"last_name":{"type":"string","description":"The shipping last name."},"address_line_1":{"type":"string","description":"The shipping first address line."},"address_line_2":{"type":"string","description":"The shipping second address line."},"city":{"type":"string","description":"The shipping city."},"state":{"type":"string","description":"The shipping state."},"zip":{"type":"string","description":"The shipping ZIP and or postal code."},"company":{"type":"string","description":"The shipping company."},"country":{"type":"string","description":"The shipping country in three letter ISO 3166-1 alpha-3 format."},"email":{"type":"string","format":"email","description":"The shipping email."},"phone":{"type":"string","description":"The shipping phone."}}}}}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"description":"","properties":{"api_call_id":{"type":"string","description":"A 20 character API call ID.","minLength":20,"maxLength":20},"api_call_unix":{"description":"Unix timestamp of when the API call was initiated.","type":"integer","format":"unix-time"},"code":{"description":"API call response code.","type":"integer","format":"int32","enum":[1]},"subscription_id":{"type":"string","description":"A 20 character subscription ID.","minLength":20,"maxLength":20},"result":{"type":"string"}},"type":"object","additionalProperties":false}}},"description":"Successful response."},"default":{"content":{"application/json":{"schema":{"description":"","properties":{"api_call_id":{"type":"string","description":"A 20 character API call ID.","minLength":20,"maxLength":20},"api_call_unix":{"description":"Unix timestamp of when the API call was initiated.","type":"integer","format":"unix-time"},"code":{"description":"This value indicates that there is an error. Will always be 0.","type":"integer","enum":[0]},"error_code":{"description":"The specific error code.","type":"string"},"message":{"description":"A human readable description of the error.","type":"string"},"result":{"description":"A description of the API call result.","type":"string"}},"title":"APIStandardErrors","type":"object","additionalProperties":false}}},"description":"Error response."}}}