Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string
Maximum string length: 255
Rafflesia-Object-Lifecycle-Preference
string
Maximum string length: 8192

Body

application/json
file_name
string
required
Required string length: 1 - 512
size_bytes
integer<int64>
required
Required range: 1 <= x <= 5497558138880
content_type
string
Maximum string length: 255
path
string

Optional mutable management path. Omit to use file_name at the storage root.

Maximum string length: 1024
sha256
string

Optional caller-declared full digest used to bind resumable retries. Local uploads verify it directly; remote multipart uploads use provider-validated per-part checksums.

Pattern: ^[0-9a-f]{64}$

Response

OK

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/ExecutionEnvelopeFileUploadSession.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.