Skip to main content
Prisma Documentation Docs

Search documentation

Type to search this documentation.

List Alchemy stages

GET/v1/projects/{projectId}/branches/{branchId}/alchemy-state/state/stacks/{stack}/stagesList Alchemy stages

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

Lists the distinct stage names with state or output rows for the stack. Accepts a live deploy lease on any stage of the stack.

Parameters

projectIdstringpathrequired

pattern ^(proj_)?([cC][^\s-]{8,}|[a-z0-9]+)$

branchIdstringpathrequired

pattern ^(br_)?([cC][^\s-]{8,}|[a-z0-9]+)$

stackstringpathrequired

maxLength 200 · minLength 1

alchemy-state-lease-idstringheaderrequired

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

pattern ^(aslease_)?([cC][^\s-]{8,}|[a-z0-9]+)$

Responses

200Stage names, sorted.application/json
array of string
Example response
[
  "string"
]
401Missing or invalid authorization token.application/json
object
errorobjectrequired
Show child attributes
codestringrequired
hintstring
messagestringrequired
Example response
{
  "error": {
    "code": "string",
    "hint": "string",
    "message": "string"
  }
}
404Project or branch not found.application/json
object
errorobjectrequired
Show child attributes
codestringrequired
hintstring
messagestringrequired
Example response
{
  "error": {
    "code": "string",
    "hint": "string",
    "message": "string"
  }
}
409No live deploy lease held for this stack and stage.application/json
object
errorobjectrequired
Show child attributes
codestringrequired
hintstring
messagestringrequired
Example response
{
  "error": {
    "code": "string",
    "hint": "string",
    "message": "string"
  }
}
413Request body exceeds this endpoint's size cap.application/json
object
errorobjectrequired
Show child attributes
codestringrequired
hintstring
messagestringrequired
Example response
{
  "error": {
    "code": "string",
    "hint": "string",
    "message": "string"
  }
}
Documentation menu