---
title: "Partial update coupon"
method: PATCH
path: "/coupons/{id}/"
tags: ["Billing"]
---

# Partial update coupon

`PATCH /coupons/{id}/`

## Request body

- Coupon
  - `id` string
  - `name` string, required
  - `amount` number, required
  - `currency` string, required
  - `discount_scheme` '%' | '$'
  - `duration_scheme` 'one_time' | 'forever' | 'limited'
  - `duration_times` integer, nullable — Required when `duration_scheme=limited`. Number of billing cycles.
  - `valid_until` string, date, nullable
  - `apply_on` 'line' | 'invoice'
  - `status` 'active' | 'archived'
  - `archived` string, date-time, nullable
  - `created` string, date-time
  - `updated` string, date-time

## Response `200`

Updated coupon.

- Coupon
  - `id` string
  - `name` string, required
  - `amount` number, required
  - `currency` string, required
  - `discount_scheme` '%' | '$'
  - `duration_scheme` 'one_time' | 'forever' | 'limited'
  - `duration_times` integer, nullable — Required when `duration_scheme=limited`. Number of billing cycles.
  - `valid_until` string, date, nullable
  - `apply_on` 'line' | 'invoice'
  - `status` 'active' | 'archived'
  - `archived` string, date-time, nullable
  - `created` string, date-time
  - `updated` string, date-time

---

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