Skip to main content
POST
/
api
/
storage
/
buckets
/
{bucketName}
/
objects
Upload Object with Auto-Generated Key
curl --request POST \
  --url https://api.example.com/api/storage/buckets/{bucketName}/objects \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form file='@example-file'
{
  "bucket": "avatars",
  "key": "image-1737546841234-a3f2b1.jpg",
  "size": 102400,
  "mimeType": "image/jpeg",
  "uploadedAt": "2024-01-21T10:30:00Z",
  "url": "/api/storage/buckets/avatars/objects/image-1737546841234-a3f2b1.jpg"
}

Documentation Index

Fetch the complete documentation index at: https://docs.insforge.dev/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
bucketName
string
required
Pattern: ^[a-zA-Z0-9_-]+$

Body

multipart/form-data
​
file
file
required

File to upload

Response

Object uploaded successfully with auto-generated key

​
bucket
string
required

Name of the bucket containing the object

Example:

"avatars"

​
key
string
required

Unique key identifying the object within the bucket

Example:

"user123.jpg"

​
size
integer
required

Size of the file in bytes

Example:

102400

​
uploadedAt
string<date-time>
required

ISO timestamp when the file was uploaded

Example:

"2024-01-15T10:30:00Z"

​
url
string
required

URL to download the file

Example:

"/api/storage/buckets/avatars/objects/user123.jpg"

​
mimeType
string

MIME type of the file

Example:

"image/jpeg"