storage.upload.presigned-url

Issue a short-lived presigned PUT URL to a customer bucket and record an audit row.

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 upload into
key	string	Yes	—	Object key for the upload
content_type	string	No	—	MIME type; defaults to application/octet-stream
kind	string	Yes	—	Object kind label for the audit row
expires_s	integer	No	—	Presigned URL lifetime in seconds; default 600, max 3600
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 upload into
key	string	Yes	—	Object key for the upload
content_type	string	No	—	MIME type; defaults to application/octet-stream
kind	string	Yes	—	Object kind label for the audit row
expires_s	integer	No	—	Presigned URL lifetime in seconds; default 600, max 3600
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
presigned_url	string	No	—	Short-lived presigned PUT URL. Marked sensitive so the engine vaults it before persist; resolve via WorkflowVault / resolve_secret_references.
presigned_url_redacted	boolean	No	—	True when the short-lived URL was issued (plaintext vaulted in state)
expires_at	string	No	—	ISO 8601 UTC timestamp when the presigned URL expires
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	Issuing presigned PUT URL
completed	No	Yes	Yes	—	Presigned URL issued
failed	No	Yes	No	—	Presigned URL issuance 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.upload.presigned-url",
  "initial_data": {
    "organization_uuid": "value",
    "storage_connection_uuid": "value",
    "bucket": "value",
    "key": "value"
  }
}