kv.store.apply

Reconcile a declared Orkestia KV store on the bound provider

Reconcile an Orkestia KV store to a declared key set on the bound provider.

Inputs:

• connection_uuid: Bound provider CloudConnection (required)
• app: App slug (required)
• environment: Environment scope (required)
• namespace: Namespace (optional, defaults to app)
• vault: Default tier is secret when true (optional)
• keys: [{key, tier?, value?, ttl_seconds?}] (required)
• prune: Delete provider keys not in the declaration (optional)

Outputs (references only, no values):

• applied_count, rotated_count, pruned_count, keys

Fans out kv.key.set semantics per changed key; never spreads values.

Overview

Property	Value
Workflow type	Atomic
Library	App-kv
Version	1.0

Input Schema

Field	Type	Required	Default	Description
connection_uuid	uuid	Yes	—	Bound provider CloudConnection.
app	string	Yes	—	—
environment	string	Yes	—	—
namespace	string	No	—	Namespace (defaults to app).
vault	boolean	No	—	Default tier is secret when true.
keys	list	Yes	—	[{key, tier?, value?(sensitive), ttl_seconds?}].
prune	boolean	No	—	Delete provider keys not in the declaration.

Output Schema

Field	Type	Required	Default	Description
app	string	No	—	—
environment	string	No	—	—
namespace	string	No	—	—
provider	string	No	—	—
applied_count	integer	No	—	—
rotated_count	integer	No	—	—
pruned_count	integer	No	—	—
keys	json	No	—	per-key {key, tier, version_id, provider_resource_id} — references only.
failure_reason	string	No	—	—
failure_type	string	No	—	—
failed_action	string	No	—	—
failed_at_state	string	No	—	—
failed_step	string	No	—	—
failed_layer	string	No	—	—
error	string	No	—	—
error_type	string	No	—	—

States

State	Initial	Terminal	Success	Auto-advance	Description
pending	Yes	No	—	execute	—
completed	No	Yes	Yes	—	—
failed	No	Yes	No	—	—

State Diagram

Transitions

From	Action	To	Description
pending	execute	completed	—
* (any state)	fail	failed	—

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "kv.store.apply",
  "initial_data": {
    "connection_uuid": "value",
    "app": "value",
    "environment": "value",
    "keys": "value"
  }
}