Get service state
GEThttps://api.instacloud.com/projects/{projectId}/services/{serviceId}/state
Token scope: account · org · project — read-only tokens allowed.
A compute service's desired (developer intent) vs. live runtime state.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
projectId | path | string | yes | |
serviceId | path | string | yes |
Responses
200
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
desiredState | string | no | running|stopped|suspended |
state | string | no | running|suspended|stopped|none|unknown |
lastFailure | object | no | the newest deploy attempt's failure; omitted when the newest attempt succeeded |
lastFailure.kind | "deploy" | "build" | yes | build: no image was produced; deploy: the image was built (or given) but did not go live |
lastFailure.at | string | yes | |
lastFailure.reason | string | yes | tenant-safe: the same message the failing deploy or build already reported |
lastFailure.buildId | string | no | when the attempt was a build: `insta build logs <buildId> --source <buildSource>` |
lastFailure.buildSource | "github" | "archive" | no |
400
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |
404
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |