Skip to content

Upload a blob

POST
/v1/data/{artifactId}/blobs
curl --request POST \
--url https://shareout.site/v1/data/example/blobs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form file=@file \
--form filename=example

Max 50MB per file, 500MB per artifact, 1000 blobs.

artifactId
required
string

Artifact ID (e.g. art_abc123).

Media type multipart/form-data
object
file
required
string format: binary
filename
string

Uploaded

Media type application/json
object
success
boolean
data
object
id
string
filename
string
mimeType
string
size
integer
url
string format: uri
createdAt
string format: date-time
Example generated
{
"success": true,
"data": {
"id": "example",
"filename": "example",
"mimeType": "example",
"size": 1,
"url": "https://example.com",
"createdAt": "2026-04-15T12:00:00Z"
}
}

File too large or storage full

Media type application/json
object
success
required
boolean
error
required

Human-readable message.

string
code
required

Machine-readable error code.

string
Example
{
"success": false
}