Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.
/api/v2/media/uploadPOST
Creates a presigned upload for a local media file. PUT the raw file bytes to uploadUrl with a Content-Type header equal to mimeType, then reference publicUrl in a post's mediaItems. Supported formats: JPEG, PNG, GIF, WebP images and MP4/MOV videos. Files already hosted at a public URL can be referenced directly without uploading. Uploads require an active subscription and include 4 uploads per monthly post allowance.
Authorization
apiKey *Bearer <token>
Akarso API key from the dashboard. Token in: header
Request Bodyapplication/jsonrequired
filename *string
Original filename, including extension
Min length: 1
mimeType *string
MIME type of the file (image/jpeg, image/png, image/gif, image/webp, video/mp4, video/quicktime)
Response
200
success *boolean
data *object
Show properties
uploadUrl *string
Presigned URL — PUT the raw file bytes here with a Content-Type header matching mimeType
publicUrl *string
Public URL of the file after upload; reference it in post mediaItems
400 · Invalid request body, path, or query parameters
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
401 · Missing or invalid API key
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
402
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
subscribeUrl?string
URL to start a subscription
403
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
limit?number
The plan limit that was hit
used?number
Current usage in this billing period
connected?number
Currently connected accounts
429 · Upstream rate limit reached
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
502 · Upstream platform request failed
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
503 · Upstream service temporarily unavailable or submission outcome unknown
error *string
Human-readable error message
code?string
Machine-readable error code
message?string
Additional error details
Request example
curl -X POST "https://akarso.co/api/v2/media/upload" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "filename": "string",
  "mimeType": "string"
}'
Powered byHolocron