BUbuttondown
Attachments

List Attachments

Changed on

List all attachments

get/attachments

Request

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

Query parameters

idsstring[]

If provided, only return attachments matching the given IDs.

[
  "att_01h8xg4j3k2m1n0p9q8r7s6t5v"
]
page_sizeinteger

The number of results per page.

pageinteger

The page number of the paginated response.

Example:1

Response

OK

nextstring nullable

The URL to the next page of results, if any.

previousstring nullable

The URL to the previous page of results, if any.

countinteger required

The total number of results across all pages.

Example response

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

Changes

  • 228cc05ba97dRevision changes
    • info

      added the new optional query request parameter page

    • info

      added the non-success response with the status

  • 13f3bc084194Revision changes
    • breaking

      response property next list-of-types was widened by adding types null to media type application/json of response 200

    • breaking

      response property previous list-of-types was widened by adding types null to media type application/json of response 200

    • breaking

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

    • 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 non-success response with the status

    • info

      added the non-success response with the status