---
title: "Refresh seat products"
method: POST
path: "/v2/subscriptions/{id}/refresh-seat-products"
tags: ["Subscriptions"]
---

# Refresh seat products

`POST /v2/subscriptions/{id}/refresh-seat-products`

Triggers 'count' updates on connected seat products within the subscription. This action will use the dataloader query to retrieve and update the number of units for each seat product.

## Path parameters

- `id` string, required

## Response `201`

- object[]
  - `id` string, required — Subscription update ID.
  - `application_schedule` 'immediately' | 'next_period' | 'custom' | 'scheduled', 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.
  - `apply_at` string, date, required — Date when the subscription should be updated. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `payment_schedule` 'immediately' | 'next_invoice' | 'custom', 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.
  - `calculation_method` 'pro_rata' | 'pay_in_full' | 'do_not_charge', 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.
  - `adjustment_amount` number, nullable, 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` union — The next refresh date. Exists if your seat item is configured to be refreshed periodically.
    - string, date
    - string

---

[API](https://skmtc.dev/hyperline/apis/hyperline-api.md) · [All operations](https://skmtc.dev/hyperline/apis/hyperline-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hyperline/hyperline-api/revisions/19fa5f22e39b/schema)