Changelog-Einträge auflisten

Gibt die Einträge eines Changelogs nach dem Datum zurück, an dem sie angezeigt werden, zuerst die neuesten. Entwürfe ohne Datum werden nach ihrem Erstellungszeitpunkt sortiert.

GET /v1/changelogs/{id}/entries

Bearer-Token Scope content:read

curl 'https://api.ferndesk.com/v1/changelogs/art_01JXY9AZK4KV/entries?start_cursor=eyJ2IjoxLCJrIjpbIjIwMjYtMDEtMDEiLCJhcnRfMSJdfQ&page_size=20&format=markdown&status=published' \
  --request GET \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "results": [
    {
      "id": "art_01JXY9AZK4KV",
      "changelogId": "col_01JXYA6ABN52",
      "title": "Faster search",
      "slug": "faster-search",
      "contentHtml": "<p>Search results now load twice as fast.</p>",
      "contentMarkdown": "Search results now load twice as fast.",
      "contentJson": {
        "type": "doc",
        "content": [
          {
            "type": "paragraph",
            "content": [
              {
                "type": "text",
                "text": "Welcome to Ferndesk."
              }
            ]
          }
        ]
      },
      "url": "https://docs.example.com/faster-search-A1B2C3",
      "status": "published",
      "date": "2026-09-30",
      "tags": [
        "new"
      ],
      "announce": false,
      "publishedAt": "2026-09-30T14:02:11.000Z",
      "createdAt": "2026-01-15T18:25:43.511Z",
      "updatedAt": "2026-01-15T18:25:43.511Z",
      "draft": {
        "id": "drft_01JXY9AZK4KV",
        "title": "Faster search",
        "contentHtml": "<p>Search results now load twice as fast.</p>",
        "contentMarkdown": "Search results now load twice as fast.",
        "contentJson": {
          "type": "doc",
          "content": [
            {
              "type": "paragraph",
              "content": [
                {
                  "type": "text",
                  "text": "Welcome to Ferndesk."
                }
              ]
            }
          ]
        },
        "source": "api",
        "updatedAt": "2026-01-15T18:25:43.511Z"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "eyJ2IjoxLCJrIjpbIjIwMjYtMDEtMDEiLCJhcnRfMSJdfQ"
}

Cursor-paginierte Einträge

Pfadparameter

· 1

id string erforderlich

Kennung der angeforderten Ressource.

Query-Parameter

· 4

start_cursor string

Undurchsichtiger Cursor aus dem vorherigen Antwortfeld next_cursor.

page_size integer · min: 1· max: 100· Standard: 20

Elemente pro Seite.

format string · Standard: html· Enum

Welches Textkörperfeld befüllt werden soll: contentHtml, contentMarkdown oder das verlustfreie contentJson.

Werte

html
markdown
json

status string · Standard: published· Enum

Welche Einträge eingeschlossen werden sollen; für draft und all ist content:write erforderlich.

Werte

draft
published
all

Pfadparameter

Query-Parameter

Antworten