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

Import media from a URL

POST
/v1/media/imports

For a file that already has a public address: eksis downloads it into the media library and answers with the finished media, so there is no upload or complete step. The address must be public http(s) and point straight at the file. Accepted types: JPEG, PNG, WebP, MP4, QuickTime, WebM.

Authorization

headerAuthorizationBearer <token>

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

Request Body

application/json
  1. body
url*string
Formaturi
filename?string

Name to keep in the library. Defaults to the file name in the URL.

Lengthlength <= 120

Response Body

The media is in the library and ready to use.

application/json
  1. response
data?
curl -X POST 'https://api.eksis.io/v1/media/imports' \  -H 'Authorization: Bearer eksis_sk_...' \  -H 'Content-Type: application/json' \  -d '{  "url": "http://example.com"}'
{  "data": {    "id": "string",    "filename": "string",    "url": "http://example.com",    "kind": "image",    "mime": "string",    "size": 0,    "width": 0,    "height": 0,    "durationMs": 0,    "status": "uploading",    "createdAt": "2019-08-24T14:15:22Z"  }}