Buttondown logo

Creating an attachment

Upload a new attachment to your Buttondown account.

This endpoint expects a multipart form data request with:

  • file (required): The file to upload
  • name (optional): A custom name for the attachment. If not provided, the original filename will be used.

Sample requests

These sample requests are autogenerated by the OpenAPI spec.

import requests

url = "https://api.buttondown.com/v1/attachments"
headers = {
  "Authorization": "Token $BUTTONDOWN_API_KEY"
}
files = {
    "file": open("path/to/your/image.jpg", "rb")
}

response = requests.request("POST", url, headers=headers, files=files)
print(response.text)

Sample responses

The IDs and values referenced in these responses are fake; please only rely on these responses for overall structure.

{
    "id": "att_1234567890",
    "creation_date": "2000-01-01T00:00:00",
    "name": "newsletter-guide.pdf",
    "file": "https://buttondown.s3.amazonaws.com/attachments/newsletter-guide.pdf",
    "size": 1000
}

Body parameters

All parameters are optional unless explicitly specified.

name

Type
string