BUbuttondown
Images

List Images

Changed on

List all uploaded images

get/images

Request

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

Query parameters

idsstring[]

If provided, only return images matching the given IDs.

[
  "img_01h8xg4j3k2m1n0p9q8r7s6t5v"
]
pageinteger

The page number to return.

page_sizeinteger

The number of results per page.

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": [
    {
      "image": "https://placecats.com/408/287"
    }
  ]
}

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 Images added

    • info

      added the new optional query request parameter ids

    • info

      added the new optional query request parameter page_size

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property // to the response with the status