Images

Images are, well, images! Buttondown allows you to upload images to its secure S3 bucket and do with them what you will. This is sort of an odd duck of an API, to be sure, but if you want to be able to do things like draft and send emails completely on your iPad you need a surefire way of creating images.

The image object

An image looks like this:

{
    "creation_date": "2019-08-24T14:15:22Z",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "image": "string"
}

Listing images

GET → https://api.buttondown.email/v1/images

Parameters

Responses

{
    "count": 1,
    "next": "foo",
    "previous": null,
    "results": [
        {
            "creation_date": "2019-08-24T14:15:22Z",
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "image": "string"
        }
    ]
}

Uploading a new image

POST → https://api.buttondown.email/v1/images

Parameters

Responses

{
    "creation_date": "2019-08-24T14:15:22Z",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "image": "string"
}

Deleting an image

DELETE → https://api.buttondown.email/v1/images/<id>

Responses

{}

Retrieving a specific image

GET → https://api.buttondown.email/v1/images/<id>

Responses

{
    "creation_date": "2019-08-24T14:15:22Z",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "image": "string"
}