Boring.host is taking a short break. Uploads are paused for now. We'll be back soon.

API

Our api is openly accessible. Please contact us if you need your domain included in the CORS headers.

Uploading image(s)

URL:

POST https://api.boring.host/api/v1/upload

Example form data:

{
    "api_token": "your api token",
    "file": "filedata",
    "files[]": "filedata",
    "files[]": "filedata"    
}

Example response:

{
    "success": true,
    "images": [
        {
            "code": "2HT4OC",
            "filename": "9pZ0x4V.jpg",
            "extension": "jpg",
            "url": "https://boring.host/2HT4OC",
            "direct_url": "https://i.boring.host/2HT4OC.jpg",
            "size": 1180287,
            "manage_token": "cuxo9cl331CxOj5nnvSC0cwM4KLU7WO0rJV4kIdV6f4ATEcHp19SLLrI6pqO"
        },
        {
            "code": "2IgZSb",
            "filename": "NhOnDu8.jpg",
            "extension": "jpg",
            "url": "https://boring.host/2IgZSb",
            "direct_url": "https://i.boring.host/2IgZSb.jpg",
            "size": 611243,
            "manage_token": "aCzLlRIoidg33NDH8SuY3TY7Fmb4XsyKIxsxqN1OTlsrDMrigyJ38VuaUNDs"
        }
    ],
    "album": {
        "code": "E29oh",
        "name": null,
        "manage_token": "VWLTIUE5urisxtjeSssLyD2z6RAUWeO2PVRw4NOz7W8OH9cj1qpTQO1CPh3Z"
    },
    "errors": [],
    "remaining": 23
}

Deleting an image

URL:

DELETE https://api.boring.host/api/v1/images/{code}/delete

Example form data:
You can either pass through your api token or manage_token from the image

{
    "api_token": "your api token",
    "manage_token": "manage token"
}

Example response:

{
    "success": true
}

Deleting an album

URL:

DELETE https://api.boring.host/api/v1/album/{code}/delete

Example form data:
You can either pass through your api token or manage_token from the image

{
    "api_token": "your api token",
    "manage_token": "manage token"
}

Example response:

{
    "success": true
}