Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

A Rafflesia API key, sent as Authorization: Bearer <key>.

Headers

X-Filename
string

Mutable management path for the file. A plain filename places it in the storage root.

Maximum string length: 1024
Idempotency-Key
string

Retry identity for this exact file, filename, content type, initial ACL, and requested lifetime.

Maximum string length: 255
Rafflesia-Object-Lifecycle-Preference
string

JSON object whose initial_acl and expiration_duration_seconds apply to the uploaded file.

Maximum string length: 8192

Body

*/*

The body is of type file.

Response

Uploaded file URL.

ok
boolean
required

Whether the operation succeeded.

provenance
object
required

Execution provenance.

warnings
object[] | null
required

Non-fatal warnings.

$schema
string<uri>
read-only

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/ExecutionEnvelopeFileUpload.json"

data
object

Operation result data. Absent when the operation did not succeed.

error
object

Structured execution error information.

evidence
object

Mechanical evidence summary for agent inspection and chaining.