Skip to main content
POST
Queue an owner-authorized StackKits service action

प्राधिकरण

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

पथ पैरामीटर

serviceId
string
आवश्यक

Canonical service runtime ID

बॉडी

application/json

Either an agent-executed runtime action bound to a fresh inventory revision, or an owner lock action executed entirely in the control plane. The lock is not bound to an inventory observation: an owner must be able to freeze a service whose agent is unreachable.

action
enum<string>
आवश्यक

update runs the StackKit upgrade of the owning stack to the pinned release; it is accepted only while allowed_actions advertises it.

उपलब्ध विकल्प:
start,
stop,
restart,
logs,
update
expected_inventory_revision
integer<int64>
आवश्यक
आवश्यक सीमा: x >= 1
owner_approved
boolean
आवश्यक

Required true for start, stop and restart; logs is read-only.

limit
integer

Logs only; defaults to 100.

आवश्यक सीमा: 1 <= x <= 200
cursor
string

Logs only; opaque StackKits cursor from the prior page.

Maximum string length: 2048

प्रतिक्रिया

Action queued or exact durable replay returned

data
object
meta
object