List published block revisions
/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);
}# Requires email_management:read permission in the target workspace.
for revision in client.email.blocks.languages.revisions.list("ebl_01krdgeqcxet5s7t44vh8rt9mg", "en"):
print(revision.id, revision.version_number, revision.published_at)// Requires email_management:read permission in the target workspace.
client, err := bird.NewClient(option.WithAPIKey(os.Getenv("BIRD_API_KEY")))
if err != nil {
log.Fatal(err)
}
revisions := client.Email.Blocks.Languages.Revisions.List(context.Background(),
"ebl_01krdgeqcxet5s7t44vh8rt9mg", "en", bird.EmailBlocksLanguagesRevisionsListParams{})
for revision, err := range revisions {
if err != nil {
log.Fatal(err)
}
fmt.Println(revision.Id, revision.VersionNumber, revision.PublishedAt)
}// Requires email_management:read permission in the target workspace.
foreach ($bird->email->blocks->languages->revisions->list('ebl_01krdgeqcxet5s7t44vh8rt9mg', 'en') as $revision) {
echo $revision->getId(), ' ', $revision->getVersionNumber(), "\n";
}bird email blocks languages revisions list <block-id> <language>curl -X GET "https://us1.platform.bird.com/v1/email/blocks/{block_id}/languages/{language}/revisions" \
-H "Authorization: Bearer $TOKEN" \
--url-query "sort=version_number" \
--url-query "order=desc" \
--url-query "limit=25" \
--url-query "include_total=false"{
"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_idstringBlock to read or edit.
languagestringExact block language as a BCP-47 tag. No fallback is applied.
Paramètres de requête
sortstringField to sort by. Defaults to version_number.
Possible values: version_number
orderstringSort direction. Defaults to desc, which sorts from newest to oldest or largest to smallest, depending on the selected sort field.
Possible values: asc, desc
limitintegerMaximum number of items to return per page.
starting_afterstringCursor from the next_cursor field of a previous list response. Returns items immediately after the cursor position in the current sort order.
ending_beforestringCursor 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_totalbooleanWhen 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
datanext_cursorCursor for the next page. Pass back as starting_after to advance forward. null when no next page exists.
prev_cursorCursor for the previous page. Pass back as ending_before to step backward. null when no previous page exists.
refresh_cursorRefresh 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.
totalTotal number of items matching the request's filters across all pages. Present only when include_total=true was passed, and omitted otherwise.
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet.