A valid request URL is required to generate request examples{
"posts": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"slug": "<string>",
"title": "<string>",
"body_markdown": "<string>",
"published_at": "2023-11-07T05:31:56Z"
}
],
"max_age_seconds": 123,
"generated_at": "2023-11-07T05:31:56Z"
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}The public release page
What you shipped, for anybody. Addressed by publishable key and public, in the same family as GET /v1/pricing/{publishable_key} and the help center: read it, cache it, render it — it is what a /changelog page on your own site is made of.
It carries only the posts aimed at nobody in particular. A post targeted at a segment is absent, and that is the design rather than a limitation: a publishable key sits in your page’s HTML, so this document has no reader to resolve. Honouring the audience would need an identifier supplied by the caller, and a document that answers “here is the post for this address” is an oracle for who is in which segment — answerable by anybody with a page and a list of emails. Targeted posts are reachable only through GET /v1/contact/changelog, where the reader was proven by a credential rather than named by a caller.
Drafts are structurally absent: the query carries published_at IS NOT NULL in its own WHERE, so there is no filter for a handler to forget.
Cache-Control: public, max-age=60, stale-while-revalidate=600, stale-if-error=600. When you cannot fetch it, keep the copy you have — a release page that cannot render because we are having a bad minute is a hole in your site over an outage of ours.
Bounded to the 50 most recent posts. Deliberately not paginated: a cursor on a cacheable document multiplies the cache entries by the number of positions a reader can be in, and what this renders is the recent releases.
Rate limited to 240 requests per minute per IP.
A valid request URL is required to generate request examples{
"posts": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"slug": "<string>",
"title": "<string>",
"body_markdown": "<string>",
"published_at": "2023-11-07T05:31:56Z"
}
],
"max_age_seconds": 123,
"generated_at": "2023-11-07T05:31:56Z"
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}{
"error": {
"code": "forbidden",
"message": "your role does not allow this action"
}
}Parâmetros de caminho
uk_pk_live_… or uk_pk_test_…. Posts are per environment, like the key.
Resposta
The published, untargeted posts, newest first.