POST
https://spideriq.ai
/
api
/
v1
/
media
/
files
/
upload
Upload File
curl --request POST \
  --url https://spideriq.ai/api/v1/media/files/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "folder": "<string>"
}
'
{
  "success": true,
  "url": "https://media.spideriq.ai/client-cli-abc123/logos/company-logo.png",
  "key": "logos/company-logo.png",
  "content_type": "image/png",
  "size": 15234,
  "bucket_name": "client-cli-abc123"
}
Upload files (images, documents, etc.) to your dedicated SpiderMedia bucket.
The API playground above does not support file uploads. Use cURL, Postman, or code examples below instead. This endpoint requires multipart/form-data, not JSON.

​
Request

​
file
file
required
The file to upload (max 100MB)
​
folder
string
Optional folder path within your bucket (e.g., “logos”, “images/products”)

​
Response

​
success
boolean
Whether the upload succeeded
​
url
string
Public URL to access the uploaded file
​
key
string
File key within the bucket
​
content_type
string
MIME type of the uploaded file
​
size
integer
File size in bytes

​
Example

curl -X POST "https://spideriq.ai/api/v1/media/files/upload" \
  -H "Authorization: Bearer cli_abc123:sk_xxx:secret_xxx" \
  -F "file=@company-logo.png" \
  -F "folder=logos"

{
  "success": true,
  "url": "https://media.spideriq.ai/client-cli-abc123/logos/company-logo.png",
  "key": "logos/company-logo.png",
  "content_type": "image/png",
  "size": 15234,
  "bucket_name": "client-cli-abc123"
}