List blueprint-instances

GET

/blueprint-instances

• Current canonical versioned path (F3.API.01)

A deployed instance of a Blueprint. Tracks which blueprint was used, the resolved param values, the resulting cloud-instance, and its lifecycle status.

Authorizations

• bearerAuth
• apiTokenAuth

Parameters

Query Parameters

pagination[page]

integer

pagination[pageSize]

integer

filters

Strapi REST filter syntax

object

sort

string

populate

string

Responses

200

OK

object

data

Array

object

blueprint

required

One of:

string

DocumentId reference to api::blueprint.blueprint

string

object

object

key

additional properties

any

param_values

required

Resolved parameter values used when rendering the blueprint template, e.g. {“region”: “eu-central-1”, “size”: “cx21”}.

status

required

string

Allowed values: pending provisioning ready failed destroyed deployed

cloud_instance

One of:

string

DocumentId reference to api::cloud-instance.cloud-instance

string

object

object

key

additional properties

any

organisation

required

One of:

string

DocumentId reference to api::organisation.organisation

string

object

object

key

additional properties

any

deployed_by

One of:

string

DocumentId reference to plugin::users-permissions.user

string

object

object

key

additional properties

any

deployed_at

string format: date-time

notes

string

resources

Per-resource progress array: [{resource_id, resource_type, name, status: ‘pending’|‘provisioning’|‘ready’|‘failed’, provider, region, cost_estimate_usd, error_msg?}]

total_cost_estimate_usd

Sum of all resource cost estimates in USD/month.

number

resource_count

Total number of resources in this blueprint instance.

integer

resources_ready

Number of resources in ‘ready’ state.

integer

resources_failed

Number of resources in ‘failed’ state.

integer

progress_pct

(ready + failed) / resource_count * 100

integer

documentId

string

id

integer

createdAt

string format: date-time

updatedAt

string format: date-time

publishedAt

string format: date-time

nullable

meta

object

pagination

object

page

integer

pageSize

integer

pageCount

integer

total

integer

401

Missing or invalid authentication

403

Not authorized (tenant scope or capability)