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

Autorisierungen

Authorization
string
header
erforderlich

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

Header

Idempotency-Key
string
erforderlich

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

Pfadparameter

id
string
erforderlich

Stack ID

Body

application/json
provider_id
enum<string>
erforderlich

Canonical executable provider identifier; historical display aliases are rejected.

Verfügbare Optionen:
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>
Standard:worker
Verfügbare Optionen:
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}$

Antwort

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

data
object
erforderlich
meta
object
erforderlich