BUbuttondown
Attachments

Create Attachment

Changed on

Upload a new attachment

post/attachments

Request

  • Base URL
    https://api.buttondown.com/v1
  • URL
    https://api.buttondown.com/v1/attachments
  • Auth
    API key in header Authorization

Request body multipart/form-data

filestring binary required
namestring nullable

Response

Created

idstring required

A unique TypeID associated with the object.

creation_datestring date-time required

The date and time at which the object was first created.

namestring required

The name of the attachment.

filestring required

The URL of the attachment file.

sizeinteger required

The size of the attachment in bytes.

Example response

{
  "name": "newsletter-guide.pdf",
  "file": "https://buttondown.s3.amazonaws.com/attachments/newsletter-guide.pdf",
  "size": 1000
}

Changes

  • 228cc05ba97dRevision changes
    • info

      added the non-success response with the status

  • 13f3bc084194Revision changes
    • breaking

      the response's property type changed from no type to string for status

    • warning

      deleted the query request parameter name

    • info

      the endpoint scheme security ApiKeyAuth was added to the API

    • info

      the endpoint scheme security PermissionAuthenticationRequirement was removed from the API

    • info

      api tag Attachments added

    • info

      added the new optional request property

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status