[Experimental]

Delete Alchemy stack state

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

Deletes every resource-state and output row of the stack, or only the given stage's rows when the stage query parameter is set. Requires a live deploy lease on the affected stage; without a stage it additionally requires that no other stage of the stack holds a live lease, so one stage's deploy can never delete state another stage's deploy is using. Idempotent.

delete/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}

Request

  • Base URL: https://api.prisma.io
  • URL: https://api.prisma.io/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}
  • 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
stackstring required

Query parameters

stagestring

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.

Response

Deleted (or already absent).

Changes

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