Skip to main content
POST
Add one managed Node through native provider control

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string
required

One opaque, case-sensitive Add-Server attempt key. Supply exactly one value without leading/trailing whitespace, comma separators, or control characters. Maximum 256 UTF-8 bytes.

Required string length: 1 - 256

Path Parameters

id
string
required

Stack ID

Body

application/json
provider_id
enum<string>
required

Canonical executable provider identifier; historical display aliases are rejected.

Available options:
centron,
ionos
provider_region
string

Provider region. For IONOS this is normalized to the canonical datacenter identifier.

Maximum string length: 128
ionos_datacenter
string

IONOS datacenter alias for provider_region; ignored for other canonical providers.

Maximum string length: 128
node_role
enum<string>
default:worker
Available options:
foundation,
worker,
storage
runtime_offering_id
string

Canonical managed-runtime offering. Omission uses the stack's snapshotted effective default.

stackkit
string

StackKit foundation requested for this server.

services
string[]

Service keys; duplicates and order are semantically insignificant.

Maximum array length: 128
Required string length: 1 - 128
Pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$

Response

Native managed-runtime admission accepted or safely replayed; provisioning remains pending.

data
object
required
meta
object
required