Agent-readable docs index: /llms.txt. Full docs in one file: /llms-full.txt. Download /docs.zip to grep all markdown files locally.
/api/v1/media/from-urlPOST
Imports a media file from a publicly accessible URL. The returned id goes into a post's data.<PLATFORM>.uploadIds.
Authorization
apiKey *Bearer <token>
Akarso API key from the dashboard. Token in: header
Request Bodyapplication/jsonrequired
url *string (uri)
Publicly accessible URL of the file to import
Response
200
id *string
Upload ID, referenced by post data.<PLATFORM>.uploadIds
url?string | null
Public URL of the uploaded file
thumbnailUrl?string | null
type?"image" | "video" | "document"
width?number | null
height?number | null
fileSize?number | null
videoLength?number | null
mime?string | null
ext?string | null
createdAt?string | null
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
502 · Upstream platform request failed
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/v1/media/from-url" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://example.com"
}'
Powered byHolocron