POST
/
v2
/
subscriptions
/
{id}
/
refresh-seat-products
curl --request POST \
  --url https://api.hyperline.co/v2/subscriptions/{id}/refresh-seat-products \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "supd_MkTDgpM6ej6f8l",
    "application_schedule": "immediately",
    "apply_at": "2023-11-30T18:24:34.496Z",
    "payment_schedule": "immediately",
    "calculation_method": "pro_rata",
    "adjustment_amount": 123,
    "subscription_id": "sub_7aWtG7Gb_fwGno",
    "product_id": "itm_G6nU9iSC7eoDsk",
    "previous_count": 2,
    "new_count": 7,
    "next_refresh_date": "<string>"
  }
]

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Response

201 - application/json
id
string
required

Subscription update ID.

application_schedule
enum<string>
required

Indicates when the subscription should be updated.

  • immediately: The subscription will be updated immediately.
  • next_period: The subscription will be updated at the end of the current billing period.
  • custom: The subscription will be updated at a custom date.
Available options:
immediately,
next_period,
custom
apply_at
string
required

Date when the subscription should be updated. UTC date time string in the ISO 8601 format.

payment_schedule
enum<string>
required

Indicates when the subscription should be billed.

  • immediately: The subscription will be billed immediately.
  • next_invoice: The subscription will be billed at the next invoice.
  • custom: The subscription will be billed at a custom date.
Available options:
immediately,
next_invoice,
custom
calculation_method
enum<string>
required

Indicates how the products price should be calculated.

  • pro_rata: The price will be calculated proportionally to the time elapsed since the last billing period.
  • pay_in_full: The price will be calculated for the entire billing period.
  • do_not_charge: The price will not be calculated.
Available options:
pro_rata,
pay_in_full,
do_not_charge
adjustment_amount
number | null
required

Amount to adjust the subscription price.

subscription_id
string
required

Subscription ID.

product_id
string
required

Product ID.

previous_count
number
required

Previous count.

new_count
number
required

New count.

next_refresh_date

The next refresh date. Exists if your seat item is configured to be refreshed periodically.

Get subscriptionGet apps