The API reference moved here from eksis.io/developers.
Media

Start an upload

POST
/v1/media/uploads

Uploading takes two steps. This one reserves the media id and hands back a pre-signed URL; you then PUT the bytes straight to storage and call complete. The file never passes through the API, so a large video does not sit in an API instance’s memory.

Accepted types: JPEG, PNG, WebP, HEIC, MP4, QuickTime, WebM.

Authorization

headerAuthorizationBearer <token>

Send your key as Authorization: Bearer eksis_sk_....

Request Body

application/json
  1. body
filename*string
Lengthlength <= 255
mime*string
size*integer

Bytes. Checked against the plan’s storage quota.

Range1 <= value
folderId?string|null

Response Body

Upload where uploadUrl says, with the headers given, then call complete.

application/json
  1. response
data?
curl -X POST 'https://api.eksis.io/v1/media/uploads' \  -H 'Authorization: Bearer eksis_sk_...' \  -H 'Content-Type: application/json' \  -d '{  "filename": "string",  "mime": "string",  "size": 1}'
{  "data": {    "mediaId": "string",    "uploadUrl": "http://example.com",    "method": "PUT",    "headers": {      "property1": "string",      "property2": "string"    },    "url": "http://example.com"  }}