Tags

List all tags

get/tags

Request

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

Query parameters

idsstring[]

If provided, only return tags matching the given IDs.

[
  "tag_abc123"
]
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.

Changes

    • info

      added the new optional query request parameter page

    • info

      added the non-success response with the status

    • 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

      response property results/items/description 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 Tags added

    • 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

    • info

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