Sign in

v37

latestOpenAPI 3.1.0raw.githubusercontent.com2025-11-11200148.2 KB
Stacks

Get stack status

Retrieve current status and information about a stack and its services

get/v1/stacks/{id}

Path parameters

idstring required

Stack identifier

Example:stk_abc123

Response

Stack status information

idstring required

Stack identifier

phase'starting' | 'building' | 'deploying' | 'running' | 'failed' | 'stopped' required

Stack lifecycle phases

readyAtstring

When stack became ready (ISO 8601)

lastErrorstring

Last error message (if failed)

lastLogsstring[]

Recent log entries (truncated for size)

portsnumber[]

Active ports (if running)

etagstring required

ETag for caching

Example response

{
  "id": "stk_abc123",
  "phase": "running",
  "readyAt": "2025-10-28T12:00:00Z",
  "lastError": "Failed to start: port 3000 already in use",
  "lastLogs": [
    "npm install",
    "npm start",
    "Server listening on port 3000"
  ],
  "ports": [
    3000,
    8080
  ],
  "etag": "sha256:abc123..."
}