changelog.v1.ChangelogService
ListPosts
List published post summaries, newest first. Use limit 1 to poll for the latest post.
Method
POST
Path
changelog.v1.ChangelogService/ListPosts
Service
changelog.v1.ChangelogService
Visibility
Public endpoint
POST
changelog.v1.ChangelogService/ListPosts Request
Testnet
curl --request POST \ \
--url 'https://api.testnet.polyester.com/changelog.v1.ChangelogService/ListPosts' \
--header 'Content-Type: application/json' \
--header 'Connect-Protocol-Version: 1' \
--data '{
"limit": 100,
"pageToken": "eyJvZmZzZXQiOjEwMH0"
}'Responses
{
"nextPageToken": "eyJvZmZzZXQiOjIwMH0",
"posts": [
{
"actionRequiredCount": 1,
"breakingChangeCount": 1,
"bugFixCount": 1,
"changeCount": 1,
"coverageCutoff": "2025-01-01T00:00:00Z",
"improvementCount": 1,
"introduction": "value",
"newFeatureCount": 1,
"publishedAt": "2025-01-01T00:00:00Z",
"slug": "value",
"title": "My Trading Board"
}
]
}Request
changelog.v1.ListPostsRequestResponse
changelog.v1.ListPostsResponse limit integer (int32)
Maximum posts to return. 0 means the default of 20; maximum 100.
pageToken string
Opaque, keyset-backed, exclusive cursor from a previous response. Bound to publication time and slug.
11 fields
slug string
Stable post identifier, unique within this environment.
title string
Title.
introduction string
Introduction.
publishedAt string (date-time)
Publication time.
coverageCutoff string (date-time)
Exclusive upper bound of the period covered. Omitted when unknown.
changeCount integer (int32)
Exact number of changes.
breakingChangeCount integer (int32)
Exact number of BREAKING_CHANGE changes.
actionRequiredCount integer (int32)
Exact number of changes with action_required.
newFeatureCount integer (int32)
Exact number of NEW_FEATURE changes.
improvementCount integer (int32)
Exact number of IMPROVEMENT changes.
bugFixCount integer (int32)
Exact number of BUG_FIX changes.
nextPageToken string
Cursor for the next page. Empty when no more results exist.
| Key | HTTP status | Connect code | Error | When |
|---|---|---|---|---|
| unauthenticated | 401 | unauthenticated | Unauthenticated | Authentication required. |
| permission-denied | 403 | permission_denied | Permission Denied | Permission denied. |
| invalid-argument | 400 | invalid_argument | Invalid Argument | Invalid argument. |
| not-found | 404 | not_found | Not Found | Not found. |
| unavailable | 503 | unavailable | Unavailable | Service unavailable. |