storage.object.put

Server-side write of a small object (<=25 MB) to a customer bucket; records full audit metadata.

Overview

Property	Value
Workflow type	Atomic
Library	App-storage
Version	1.0

Input Schema

Field	Type	Required	Default	Description
organization_uuid	string	Yes	—	UUID of the organization that owns the connection
storage_connection_uuid	string	Yes	—	UUID of the CloudConnection to use
bucket	string	Yes	—	Bucket to write into
key	string	Yes	—	Object key to write
content_b64	string	Yes	—	Base64-encoded object body (max 25 MB decoded); never echoed on output
content_type	string	No	—	MIME type; defaults to application/octet-stream
kind	string	Yes	—	Object kind label for the audit row
display_name	string	No	—	Human-facing filename for pickers; defaults to the key basename
width	integer	No	—	Optional pixel width for image/video objects
height	integer	No	—	Optional pixel height for image/video objects
duration_ms	integer	No	—	Optional duration in milliseconds for video/audio objects
ref_session_uuid	string	No	—	Optional ref: session UUID to tag the audit row
ref_config_uuid	string	No	—	Optional ref: config UUID to tag the audit row
ref_skill_uuid	string	No	—	Optional ref: skill UUID to tag the audit row

Output Schema

Field	Type	Required	Default	Description
organization_uuid	string	Yes	—	UUID of the organization that owns the connection
storage_connection_uuid	string	Yes	—	UUID of the CloudConnection to use
bucket	string	Yes	—	Bucket to write into
key	string	Yes	—	Object key to write
content_type	string	No	—	MIME type; defaults to application/octet-stream
kind	string	Yes	—	Object kind label for the audit row
display_name	string	No	—	Human-facing filename for pickers; defaults to the key basename
width	integer	No	—	Optional pixel width for image/video objects
height	integer	No	—	Optional pixel height for image/video objects
duration_ms	integer	No	—	Optional duration in milliseconds for video/audio objects
ref_session_uuid	string	No	—	Optional ref: session UUID to tag the audit row
ref_config_uuid	string	No	—	Optional ref: config UUID to tag the audit row
ref_skill_uuid	string	No	—	Optional ref: skill UUID to tag the audit row
storage_object_uuid	string	No	—	UUID of the upserted StorageObject audit row
size_bytes	integer	No	—	Byte size of the written object
sha256	string	No	—	SHA-256 hex digest of the written object
etag	string	No	—	ETag returned by the storage driver
failure_reason	string	No	—	Engine-stamped human-readable failure reason
failed_at	string	No	—	ISO timestamp when the workflow failed
failed_at_state	string	No	—	Engine-stamped state when the workflow failed
failed_step	string	No	—	Engine-stamped step name (DAG path)
failed_layer	integer	No	—	Engine-stamped layer index (DAG path)
error	string	No	—	Engine-stamped exception message
error_type	string	No	—	Engine-stamped exception class name

States

State	Initial	Terminal	Success	Auto-advance	Description
pending	Yes	No	—	execute	Writing object to bucket
completed	No	Yes	Yes	—	Object written
failed	No	Yes	No	—	Object write failed

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": "storage.object.put",
  "initial_data": {
    "organization_uuid": "value",
    "storage_connection_uuid": "value",
    "bucket": "value",
    "key": "value"
  }
}