Skip to main content
POST
Queue an owned server OS update plan, OS update or reboot

प्राधिकरण

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
आवश्यक
Required string length: 1 - 128

पथ पैरामीटर

serverId
string
आवश्यक

Canonical server runtime ID

बॉडी

application/json
action
enum<string>
आवश्यक
उपलब्ध विकल्प:
os_update_plan,
os_update,
reboot
expected_inventory_revision
integer<int64>
आवश्यक
आवश्यक सीमा: x >= 1
owner_approved
boolean

Optional legacy field; it does not grant maintenance authority.

expected_plan_digest
string

os_update only: the plan_digest of a completed os_update_plan for this server that is at most 15 minutes old.

Pattern: ^sha256:[0-9a-f]{64}$

प्रतिक्रिया

Maintenance job queued or exact durable replay returned

data
object
meta
object