Menu
Platform
AI
App store purchases
Credits
Database
Flags
Generated Assets
Monitoring
Notifications
Organizations
Payments
- Payments
- Payments quickstart
- Checkout policies
- Checkout sessions
- Customer subscriptions
- Entitlement grants
- Exchange rates
- Licence keys
- Licence tokens
- Merchant accounts
- Portal sessions
- Price catalogs
- Revenue
- Revenue facts
- Revenue sources
- Tax threshold statuses
- Usage events
- Usage invoices
- Usage meter prices
- Usage meters
- Usage reservations
- Usage settings
- Usage tiers
Queues
Realtime
Sandboxes
Webhooks
Getting Started
Authentication
KV Store
Deploy & Infrastructure
Reference
On this page
Put in Objects
Writes an object's bytes, replacing the current version.
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 '{}'