Skip to content

API / Media

Method Endpoint Description
GET /api/media Get uploaded media file
POST /api/media Upload media file
DELETE /api/media/{media_id} Delete uploaded media file

GET /api/media

Get an uploaded media file.

Example Request
curl -u "username:username" -X GET 'http://localhost:9000/api/media' \
--header 'Content-Type: multipart/form-data; boundary=--------------------------093715978792575906250298'
Example Response
{
    "data": [
        {
            "id": 1,
            "uuid": "ec7b45ce-1408-4e5c-924e-965326a20287",
            "filename": "Media file",
            "created_at": "2020-04-08T22:43:45.080058+01:00",
            "thumb_url": "/uploads/image_thumb.jpg",
            "uri": "/uploads/image.jpg"
        }
    ]
}

POST /api/media

Upload a media file.

Parameters
Field Type Required Description
file File Yes Media file to upload
Example Request
curl -u "username:username" -X POST 'http://localhost:9000/api/media' \
--header 'Content-Type: multipart/form-data; boundary=--------------------------183679989870526937212428' \
--form 'file=@/path/to/image.jpg'
Example Response
{
    "data": {
        "id": 1,
        "uuid": "ec7b45ce-1408-4e5c-924e-965326a20287",
        "filename": "Media file",
        "created_at": "2020-04-08T22:43:45.080058+01:00",
        "thumb_uri": "/uploads/image_thumb.jpg",
        "uri": "/uploads/image.jpg"
    }
}

DELETE /api/media/{media_id}

Delete an uploaded media file.

Parameters
Field Type Required Description
media_id number Yes ID of media file to delete
Example Request
curl -u "username:username" -X DELETE 'http://localhost:9000/api/media/1'
Example Response
{
    "data": true
}