Sign in

v1

latestOpenAPI 3.0.32026-07-26172157253.6 KB
Client

Upload Object

Creates or replaces the object at the exact key, matching S3 PutObject semantics. End-user creates and replacements are gated by the storage.objects row-level-security policies; replacing an object never reassigns its ownership.

put/api/storage/buckets/{bucketName}/objects/{objectKey}

Path parameters

bucketNamestring required
objectKeystring required

Object key (can include forward slashes for pseudo-folders)

Response

Object created or replaced

bucketstring required

Name of the bucket containing the object

keystring required

Unique key identifying the object within the bucket

sizeinteger required

Size of the file in bytes

mimeTypestring

MIME type of the file

uploadedAtstring date-time required

ISO timestamp when the file was uploaded

urlstring required

URL to download the file

Example response

{
  "bucket": "avatars",
  "key": "user123.jpg",
  "size": 102400,
  "mimeType": "image/jpeg",
  "uploadedAt": "2024-01-15T10:30:00Z",
  "url": "/api/storage/buckets/avatars/objects/user123.jpg"
}