Skip to main content
POST
Create a StackKit deployment in the owner's Homelab

Autorizaciones

Authorization
string
header
requerido

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

Encabezados

X-Idempotency-Key
string

Stable wizard-attempt key. Maximum 256 characters.

Maximum string length: 256

Cuerpo

application/json
name
string

Stack name

mode
enum<string>

Wizard mode

Opciones disponibles:
easy,
techie
stack_spec
object

Canonical StackKits stack-spec.yaml shape generated by the creation wizard. When present, this is the source of truth for provisioning and is stored as the stack user_config for compatibility.

user_config
object

Legacy structured configuration, including older kombination-style payloads. New wizard clients should send stack_spec.

user_config_raw
string

Raw YAML/JSON string

user_config_format
enum<string>
Opciones disponibles:
json,
yaml
provider
string

Infrastructure provider (direct format)

services
string[]

Service names (direct format)

options
object

Respuesta

StackKit deployment accepted

stack_id
string
server_id
string

Canonical planned ServerRuntime created with the stack.

job_id
string
name
string
state
string
Ejemplo:

"provisioning"

message
string
operations_url
string

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

Ejemplo:

"/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.

Ejemplo:

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

owner_spec_scopes
string[]
Ejemplo: