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

Delete a file

DELETE
/v1/media/{mediaId}

Removes a file from the library. A file used by a post that has not gone out is refused with media.in_use, listing those posts in error.details.posts. With force=true it is kept until those posts go out and removed afterwards (deferred: true).

Authorization

headerAuthorizationBearer <token>

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

Path Parameters

mediaId*string

Query Parameters

force?string

Delete even when a post still uses the file.

Value in"true""false"

Response Body

The file was deleted, or will be once the posts using it go out.

application/json
  1. response
data?
curl -X DELETE 'https://api.eksis.io/v1/media/string' \  -H 'Authorization: Bearer eksis_sk_...'
{  "data": {    "id": "string",    "deleted": true,    "deferred": true,    "affectedPosts": 0  }}