Buttondown logo

Get started

Routes

Introduction

Routes

Listing imagesCreating an imageUpdating an imageDeleting an image

Buttondown logo

Updating an image

Update an image's metadata. Only the metadata field can be updated; the image file itself cannot be changed.

Sample requests

These sample requests are autogenerated by the OpenAPI spec. This endpoint requires one or more parameters in the URL: those are offset in curly-braces.

import requests

url = "https://api.buttondown.com/v1/images/{id}"
headers = {
  "Authorization": "Token $BUTTONDOWN_API_KEY"
}

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

Sample responses

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

{
    "creation_date": "2019-08-24T14:15:22Z",
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "image": "https://placecats.com/408/287"
}

Body parameters

All parameters are optional unless explicitly specified.

metadata

Type
object
Description

A structured key-value blob that you can use to store arbitrary data on the object. Metadata can be nested — you can store objects and arrays within your metadata. (You can read more about metadata.)