Buttondown logo

Get started

Routes

SnippetsModes

Routes

Listing snippetsCreating a snippetRetrieving a snippetUpdating a snippetDeleting a snippet

Buttondown logo

Listing snippets

Use the /snippets endpoint to list all of your snippets.

Sample requests

These sample requests are autogenerated by the OpenAPI spec.

import requests

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

response = requests.request("GET", 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.

{
    "results": [
        {
            "id": "snip_29fxqcmrkp969vzttksexvmvr8",
            "creation_date": "2023-01-01T00:00:00+00:00",
            "identifier": "footer",
            "name": "Footer",
            "content": "Thanks for reading!",
            "mode": "fancy",
            "reference_count": 0
        }
    ],
    "count": 1
}