Sign inGet Started

List published block revisions

GET
/v1/email/blocks/{block_id}/languages/{language}/revisions
// Requires email_management:read permission in the target workspace.
for await (const revision of bird.email.blocks.languages.revisions.list(
  "ebl_01krdgeqcxet5s7t44vh8rt9mg",
  "en",
)) {
  console.log(revision.id, revision.version_number, revision.published_at);
}
Réponse200
{
  "data": [
    {
      "id": "ebr_01krdgeqcxet5s7t44vh8rt9mg",
      "version_number": 1,
      "serializer_version": 2,
      "authoring_mode": "html",
      "source_revision_id": "ebr_01krdgeqcxet5s7t44vh8rt9mg",
      "published_by": {
        "id": "usr_01krdgeqcxet5s7t44vh8rt9mg",
        "type": "user"
      },
      "published_at": "2026-05-25T16:42:01Z",
      "created_at": "2026-05-25T16:42:01Z"
    }
  ],
  "next_cursor": "eyJ2IjoxLCJzIjoiXCIyMDI2LTA1LTI1VDE0OjAzOjEwWlwiIiwiaSI6IjAxOTJmM2IxLTRjN2UtN2EyYi05ZDYxLThmM2E1YzJlN2I0MCJ9",
  "prev_cursor": null,
  "refresh_cursor": "eyJ2IjoxLCJzIjoiXCIyMDI2LTA1LTI1VDE2OjQyOjAxWlwiIiwiaSI6IjAxOTJmM2IxLTllMDQtN2NkMy1iODE3LTJhNmY0ZDFjOGUwOSJ9"
}

Returns the retained publications of the exact language, highest version_number first by default. A version_number counts publications of the language and is separate from the draft revision. Drafts that were never published are not listed.

Paramètres

block_idstring

Block to read or edit.

languagestring

Exact block language as a BCP-47 tag. No fallback is applied.

Paramètres de requête

sortstring

Field to sort by. Defaults to version_number.

Possible values: version_number

orderstring

Sort direction. Defaults to desc, which sorts from newest to oldest or largest to smallest, depending on the selected sort field.

Possible values: asc, desc

limitinteger

Maximum number of items to return per page.

starting_afterstring

Cursor from the next_cursor field of a previous list response. Returns items immediately after the cursor position in the current sort order.

ending_beforestring

Cursor from the prev_cursor or refresh_cursor field of a previous list response. Returns items immediately before the cursor position in the current sort order. prev_cursor returns the preceding page. refresh_cursor anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since.

include_totalboolean

When true, the response includes a total field with the total number of items matching the request's filters across all pages.

Contenu de la réponse

data
array of object
obligatoire
Afficher les attributs enfants
next_cursor
nullable string
obligatoire

Cursor for the next page. Pass back as starting_after to advance forward. null when no next page exists.

prev_cursor
nullable string
obligatoire

Cursor for the previous page. Pass back as ending_before to step backward. null when no previous page exists.

refresh_cursor
nullable string
obligatoire

Refresh anchor, the first row of this response. Pass back as ending_before to fetch what precedes it in the current sort order. On a newest-first sort those are the items that have appeared since; on any other sort they are the items that sort earlier, so refreshing such a list means re-fetching it instead. Non-null whenever data is non-empty; null only on an empty page. Distinct from prev_cursor.

total
nullable integer

Total number of items matching the request's filters across all pages. Present only when include_total=true was passed, and omitted otherwise.

Poursuivez avec la documentation, les guides et les exemples sur ce sujet.