Admin APIs
block-data-approvals

Extend Contract Grace

Changed on

Account Management lengthens a contract's post-term access window.

Gated on the Accounts permission rather than the generic approvals one: extending paid access is a commercial decision, like the cancellation approve/decline pair.

Nested under /requests/{request_id}/ deliberately — that path shape is what makes AdminAuditLoggingMiddleware record the actor, body and timestamp, so who/when/why come for free and the extension appears in the request's existing timeline with no new table.

Extensions are monotonic: 422 if the proposal doesn't move the date later. 409 if the contract is no longer live — revoked access has to be re-provisioned, not restored by editing a date.

post/api/v1/admin/block/requests/{request_id}/contract-grace/extend

Request

  • Base URL: https://carbonarc.ai (the document declares no server; this is the origin it was published from)
  • URL: https://carbonarc.ai/api/v1/admin/block/requests/{request_id}/contract-grace/extend
  • Auth: OAuth 2 (authorization code, authorization URL authorize, token URL token)

Path parameters

request_idstring uuid required

Request body

extend_untilstring date-time nullable
additional_daysinteger nullable
grace_period_daysinteger nullable
reasonstring required

Response

Successful Response

block_request_idstring uuid required
contract_statusstring required
request_statusstring required
contract_ended_atstring date-time nullable
last_invoice_due_datestring date-time nullable
grace_period_days_effectiveinteger required
grace_period_days_overrideinteger nullable
grace_extended_untilstring date-time nullable
grace_extended_atstring date-time nullable
grace_extended_bystring nullable
grace_extension_reasonstring nullable
access_ends_atstring date-time nullable
in_graceboolean
grace_days_remaininginteger nullable

Changes