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

التفويضات

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.

الترويسات

Idempotency-Key
string
مطلوب

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

معلمات المسار

id
string
مطلوب

Stack ID

الجسم

application/json
provider_id
enum<string>
مطلوب

Canonical executable provider identifier; historical display aliases are rejected.

الخيارات المتاحة:
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>
افتراضي:worker
الخيارات المتاحة:
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}$

الاستجابة

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

data
object
مطلوب
meta
object
مطلوب