@@ -114,9 +114,12 @@ def sync_detailed(
114114 Permanently destroys a user graph and cancels its subscription. Two modes via the `at_period_end`
115115 body flag: omit it (or pass `false`) to tear down immediately (~10 min); pass `true` to keep the
116116 graph usable through the current billing period and tear it down at the period boundary via the
117- existing suspend → deprovision pipeline. Requires `confirm` to equal the URL `graph_id`. Caller must
118- be both org owner (billing authority) and admin on the graph (operational authority). Not allowed on
119- shared repositories.
117+ existing suspend → deprovision pipeline. An immediate delete credits the unused part of the billed
118+ period; it is not refunded. On a card-billed plan the credit goes to the organization's account
119+ balance and is applied to its next invoice; on an invoiced plan it is a credit line on that period's
120+ invoice, or a separate credit invoice if that one is already paid. Requires `confirm` to equal the
121+ URL `graph_id`. Caller must be both org owner (billing authority) and admin on the graph
122+ (operational authority). Not allowed on shared repositories.
120123
121124 **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours
122125 return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
@@ -130,7 +133,11 @@ def sync_detailed(
130133
131134 - **Immediate** (default): subscription canceled now (`ends_at = now`) and
132135 fast-path deprovisioning fires within ~10 minutes. Use when you want
133- the data gone and the slot freed right away.
136+ the data gone and the slot freed right away. The unused part of the
137+ billed period is credited, not refunded: on a card-billed plan to the
138+ organization's account balance, applied to its next invoice; on an
139+ invoiced plan as a credit on that period's invoice, or a separate credit
140+ invoice if it is already paid.
134141 - **At period end** (`at_period_end=true`): subscription canceled but
135142 `ends_at = current_period_end` so the graph stays usable through the
136143 paid period. The existing suspend → deprovision sensor pipeline tears
@@ -172,9 +179,12 @@ def sync(
172179 Permanently destroys a user graph and cancels its subscription. Two modes via the `at_period_end`
173180 body flag: omit it (or pass `false`) to tear down immediately (~10 min); pass `true` to keep the
174181 graph usable through the current billing period and tear it down at the period boundary via the
175- existing suspend → deprovision pipeline. Requires `confirm` to equal the URL `graph_id`. Caller must
176- be both org owner (billing authority) and admin on the graph (operational authority). Not allowed on
177- shared repositories.
182+ existing suspend → deprovision pipeline. An immediate delete credits the unused part of the billed
183+ period; it is not refunded. On a card-billed plan the credit goes to the organization's account
184+ balance and is applied to its next invoice; on an invoiced plan it is a credit line on that period's
185+ invoice, or a separate credit invoice if that one is already paid. Requires `confirm` to equal the
186+ URL `graph_id`. Caller must be both org owner (billing authority) and admin on the graph
187+ (operational authority). Not allowed on shared repositories.
178188
179189 **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours
180190 return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
@@ -188,7 +198,11 @@ def sync(
188198
189199 - **Immediate** (default): subscription canceled now (`ends_at = now`) and
190200 fast-path deprovisioning fires within ~10 minutes. Use when you want
191- the data gone and the slot freed right away.
201+ the data gone and the slot freed right away. The unused part of the
202+ billed period is credited, not refunded: on a card-billed plan to the
203+ organization's account balance, applied to its next invoice; on an
204+ invoiced plan as a credit on that period's invoice, or a separate credit
205+ invoice if it is already paid.
192206 - **At period end** (`at_period_end=true`): subscription canceled but
193207 `ends_at = current_period_end` so the graph stays usable through the
194208 paid period. The existing suspend → deprovision sensor pipeline tears
@@ -225,9 +239,12 @@ async def asyncio_detailed(
225239 Permanently destroys a user graph and cancels its subscription. Two modes via the `at_period_end`
226240 body flag: omit it (or pass `false`) to tear down immediately (~10 min); pass `true` to keep the
227241 graph usable through the current billing period and tear it down at the period boundary via the
228- existing suspend → deprovision pipeline. Requires `confirm` to equal the URL `graph_id`. Caller must
229- be both org owner (billing authority) and admin on the graph (operational authority). Not allowed on
230- shared repositories.
242+ existing suspend → deprovision pipeline. An immediate delete credits the unused part of the billed
243+ period; it is not refunded. On a card-billed plan the credit goes to the organization's account
244+ balance and is applied to its next invoice; on an invoiced plan it is a credit line on that period's
245+ invoice, or a separate credit invoice if that one is already paid. Requires `confirm` to equal the
246+ URL `graph_id`. Caller must be both org owner (billing authority) and admin on the graph
247+ (operational authority). Not allowed on shared repositories.
231248
232249 **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours
233250 return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
@@ -241,7 +258,11 @@ async def asyncio_detailed(
241258
242259 - **Immediate** (default): subscription canceled now (`ends_at = now`) and
243260 fast-path deprovisioning fires within ~10 minutes. Use when you want
244- the data gone and the slot freed right away.
261+ the data gone and the slot freed right away. The unused part of the
262+ billed period is credited, not refunded: on a card-billed plan to the
263+ organization's account balance, applied to its next invoice; on an
264+ invoiced plan as a credit on that period's invoice, or a separate credit
265+ invoice if it is already paid.
245266 - **At period end** (`at_period_end=true`): subscription canceled but
246267 `ends_at = current_period_end` so the graph stays usable through the
247268 paid period. The existing suspend → deprovision sensor pipeline tears
@@ -281,9 +302,12 @@ async def asyncio(
281302 Permanently destroys a user graph and cancels its subscription. Two modes via the `at_period_end`
282303 body flag: omit it (or pass `false`) to tear down immediately (~10 min); pass `true` to keep the
283304 graph usable through the current billing period and tear it down at the period boundary via the
284- existing suspend → deprovision pipeline. Requires `confirm` to equal the URL `graph_id`. Caller must
285- be both org owner (billing authority) and admin on the graph (operational authority). Not allowed on
286- shared repositories.
305+ existing suspend → deprovision pipeline. An immediate delete credits the unused part of the billed
306+ period; it is not refunded. On a card-billed plan the credit goes to the organization's account
307+ balance and is applied to its next invoice; on an invoiced plan it is a credit line on that period's
308+ invoice, or a separate credit invoice if that one is already paid. Requires `confirm` to equal the
309+ URL `graph_id`. Caller must be both org owner (billing authority) and admin on the graph
310+ (operational authority). Not allowed on shared repositories.
287311
288312 **Idempotency**: supply an `Idempotency-Key` header to make safe retries; replays within 24 hours
289313 return the same envelope. Reusing the key with a different body returns HTTP 409 Conflict.
@@ -297,7 +321,11 @@ async def asyncio(
297321
298322 - **Immediate** (default): subscription canceled now (`ends_at = now`) and
299323 fast-path deprovisioning fires within ~10 minutes. Use when you want
300- the data gone and the slot freed right away.
324+ the data gone and the slot freed right away. The unused part of the
325+ billed period is credited, not refunded: on a card-billed plan to the
326+ organization's account balance, applied to its next invoice; on an
327+ invoiced plan as a credit on that period's invoice, or a separate credit
328+ invoice if it is already paid.
301329 - **At period end** (`at_period_end=true`): subscription canceled but
302330 `ends_at = current_period_end` so the graph stays usable through the
303331 paid period. The existing suspend → deprovision sensor pipeline tears
0 commit comments