Skip to main content

List upcoming automatic renewals

GET 
/api/v1/workspaces/:id/certops/renewals/upcoming

Returns every renewable certificate in the workspace, ordered by expiry, with the date the renewal scheduler starts attempting each one (renewsFrom, computed as notAfter minus the effective lead time) and whether the scheduler would actually renew it.

Deliberately NOT restricted to certificates that will renew. A certificate with no renewal profile, or with a profile the scheduler cannot execute, is exactly the certificate that will silently expire, so excluding it would make this endpoint report an all-clear for a workspace where nothing renews at all. Every row that will not be renewed carries a blockedReason naming the cause, distinguishing an operator's deliberate switch-off from a defect.

Manager-only, matching the profile routes: each row carries the profile's lead time and identity, and the view exists to be read alongside them.

Request​

Responses​

Upcoming renewal schedule