Project detail (branches + live resources)
GEThttps://api.instacloud.com/projects/{projectId}
Token scope: account · org · project — read-only tokens allowed.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
projectId | path | string | yes |
Responses
200
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
project | object | no | |
project.id | string | no | |
project.org_id | string | no | |
project.owner_user_id | string | no | Better Auth user id (opaque string, not a UUID) |
project.name | string | no | |
project.status | "active" | "error" | "deleting" | "deleted" | no | |
project.created_at | string | no | |
branches | object[] | no | |
branches.id | string | no | |
branches.project_id | string | no | |
branches.name | string | no | |
branches.parent_branch_id | string | null | no | |
branches.is_default | boolean | no | |
branches.status | "creating" | "active" | "error" | "deleting" | no | |
branches.created_at | string | no | |
resources | object[] | no | |
resources.id | string | no | |
resources.kind | "neon" | "insta-db" | "s3" | "fly" | "insta-compute" | no | |
resources.provider | "fly" | "insta-compute" | no | Compute plane actually backing a compute resource, derived from its provider_ref rather than its kind. Absent when it cannot be determined from the row — clients must then assert no provider rather than assume one from `kind`. |
resources.name | string | null | no | compute group label for a compute resource (kind=fly | insta-compute) |
resources.branchId | string | null | no | |
resources.status | string | no | |
resources.ref | object | no | Non-credential identifiers (e.g. service url, bucket name, database project id) |
nextActions | object[] | no | |
nextActions.op | string | yes | Neutral logical action id, e.g. "service.add" — NOT an operationId or a CLI/MCP tool name; each client maps it to its own surface. |
nextActions.reason | string | yes | Natural-language, human/LLM-facing "why do this now". |
nextActions.args | object | no | Suggested, flat named arguments; "<placeholder>"s where a value is unknown. |
nextActions.gated | boolean | no | True if the action passes a governance gate. |
404
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
error | string | yes |