Skip to main content
POST
Import stack-spec.yaml as a StackKit deployment

授权

Authorization
string
header
必填

OIDC/JWKS bearer token. Self-hosted defaults to Pocket ID; SaaS uses Auth0 through the edge. PocketBase JWT is legacy migration compatibility only.

请求体

The body is of type string.

响应

Import accepted

stack_id
string
server_id
string

Canonical planned ServerRuntime created with the stack.

job_id
string
name
string
state
string
示例:

"provisioning"

message
string
operations_url
string

Durable dashboard location for rollout, retry, diagnostics, and cleanup.

示例:

"/stacks?stack_id=stack_123"

idempotent_replay
boolean

True when the response reuses an earlier creation attempt.

bootstrap_token
string

Short-lived bearer token for the StackKit owner-spec bootstrap endpoint. Present when the create request includes local owner bootstrap material.

bootstrap_token_expires_at
string<date-time>

Expiration timestamp for bootstrap_token.

owner_spec_endpoint
string

Stack-scoped endpoint consumed by StackKit admin-bootstrap.

示例:

"/api/v1/stacks/stack_123/owner-spec"

owner_spec_scopes
string[]
示例: