Skip to main content
POST
Decommission a monthly runtime lease

Authorizations

Authorization
string
header
required

OIDC/JWKS bearer token. Self-hosted defaults to Pocket ID; SaaS uses Auth0 through the edge. PocketBase JWT is legacy migration compatibility only.

Path Parameters

lease_id
string
required

Monthly runtime lease ID

Query Parameters

force
boolean
default:false

Request exact generation-bound provider reconciliation when the runtime is unreachable. Force is accepted only when the control plane can prove restart-safe, HA-fenced durable custody before it cancels the lease. Also accepted as a {"force": true} JSON body. An empty request defaults to false.

Body

application/json
force
boolean
default:false
expected_resource_generation_digest
string

Optional optimistic concurrency claim. Provider teardown is refused with 409 unless this digest still identifies the current lease resource generation.

Pattern: ^[0-9a-f]{64}$

Response

Confirmed synchronous runtime action result

data
object
meta
object