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"}
field | type | description |
---|---|---|
creation_date | datetime | |
id | uuid | |
image | string |
Listing images
GET → https://api.buttondown.email/v1/images
Parameters
parameter | type | description | optional |
---|---|---|---|
page | string | A page number within the paginated result set. Each page has 100 results. |
Responses
Status | Description | Sample Response |
---|---|---|
200 |
|
Uploading a new image
POST → https://api.buttondown.email/v1/images
Parameters
parameter | type | description | optional |
---|---|---|---|
image | string <binary> |
Responses
Status | Description | Sample Response |
---|---|---|
201 |
|
Deleting an image
DELETE → https://api.buttondown.email/v1/images/<id>
Responses
Status | Description | Sample Response |
---|---|---|
204 |
|
Retrieving a specific image
GET → https://api.buttondown.email/v1/images/<id>
Responses
Status | Description | Sample Response |
---|---|---|
200 |
|