Log in or sign up for an account

Image

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.

Basic image

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

Create Image

python
ruby
curl
Copy to clipboard
curl -X POST https://api.buttondown.email/v1/images

Responses

StatusDescriptionSample Response
201Created
{
    "creation_date": "2019-08-24T14:15:22Z",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "image": "string"
}
403Forbidden
{
    "code": "something_went_wrong",
    "detail": "Your call is very important to us."
}

Delete Image

python
ruby
curl
Copy to clipboard
curl -X DELETE https://api.buttondown.email/v1/images/{pk}

Responses

StatusDescriptionSample Response
204No Content
{}
403Forbidden
{
    "code": "something_went_wrong",
    "detail": "Your call is very important to us."
}
404Not Found
{
    "code": "something_went_wrong",
    "detail": "Your call is very important to us."
}

In the wild

Check out how Jon Sullivan uses the Buttondown API to upload images through Typora and then embed them in his newsletters.