Put in Objects

Writes an object's bytes, replacing the current version.

Checked 2026-09-28

Writes an object's bytes, replacing the current version. body is the base64 of the bytes.

Path PUT https://api.data.sylphx.com/v1/objects/bucket-id/key
Scope data:write
Effect write — a successful call changes state.
Collection objects
Host https://api.data.sylphx.com

#Request

Field	Type	What it is
`bucket_id`	`string`	The bucket's id. Required.
`key`	`string`	The object key. Required.
`body`	`bytes`	The bytes, base64.
`content_type`	`string`	The media type, for example `application/pdf`.
`expected_version`	`uint64`	Write only when the current version equals this one (0: any).

#Response

Field	Type	What it is
`object`	`ObjectRecord`	The stored object.

#ObjectRecord

Field	Type	What it is
`bucket_id`	`string`	The bucket's id in the environment, for example `uploads`.
`key`	`string`	The object key; `/` separates path segments.
`sha256`	`string`	`sha256:<hex>` of the bytes.
`size`	`uint64`	Size in bytes.
`content_type`	`string`	The media type given at put.
`etag`	`string`	The entity tag of this version.
`version`	`uint64`	The version, increasing per key.
`updated_at_unix_ms`	`int64`	When this version was written, in Unix milliseconds.
`delete_marker`	`bool`	Whether this version is a delete marker (exact-version reads only).
`visibility`	`string`	`public` or `private` (the default); current version only.

#Errors

UNAUTHENTICATED — No valid key or token was presented.
PERMISSION_DENIED — The key lacks the method's permission.
INVALID_FIELD — A field failed validation.
RESOURCE_NOT_FOUND — The named Resource does not exist or is not visible.
ETAG_MISMATCH — The etag sent does not match the Resource's current etag.

Every error arrives in the body Errors describes.

#Examples

curl -X PUT "https://api.data.sylphx.com/v1/objects/bucket-id/key" \
  -H "Authorization: Bearer $SYLPHX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Was this page helpful?

Tell us what is missing, wrong, or unclear — this opens a real inbox.

Send feedback

Platform links