[Experimental]

Heartbeat Alchemy deploy lease

⚠️ Experimental endpoint: this API is in active development and may change at any time without notice. ⚠️

Extends the unexpired deploy lease addressed by the Alchemy-State-Lease-Id header from now. A missing, replaced, or expired lease returns 404 — the lost-lease signal; an expired lease can never be revived.

patch/v1/projects/{projectId}/branches/{branchId}/alchemy-state/lease

Request

  • Base URL: https://api.prisma.io
  • URL: https://api.prisma.io/v1/projects/{projectId}/branches/{branchId}/alchemy-state/lease
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL https://auth.prisma.io/authorize, token URL https://auth.prisma.io/token, scopes: workspace:admin, offline_access)
    • HTTP bearer

Path parameters

projectIdstring required
branchIdstring required

Headers

alchemy-state-lease-idstring required

Deploy-lease id returned by the lease acquire endpoint. Addresses the lease on heartbeat and release, and authorizes every state operation.

Request body

ttlSecondsinteger

Requested lease TTL in seconds. Default 60, clamped to [30, 300].

Response

Extended the deploy lease.

Changes

No recorded changes to this operation across all 1 revision of this API.