Sign inGet Started

Get a reusable email block

GET
/v1/email/blocks/{block_id}
// Requires email_management:read permission in the target workspace.
const block = await bird.email.blocks.get("ebl_01krdgeqcxet5s7t44vh8rt9mg");
console.log(block.name, block.revision, block.archived_at);
Risposta200
{
  "id": "ebl_01krdgeqcxet5s7t44vh8rt9mg",
  "name": "Legal disclosure",
  "source_language": "pt-BR",
  "revision": 1,
  "created_by": {
    "id": "usr_01krdgeqcxet5s7t44vh8rt9mg",
    "type": "user"
  },
  "created_at": "2026-05-20T09:14:52Z",
  "updated_at": "2026-05-25T16:42:01Z"
}

Returns a block's metadata, including archived blocks. Send its revision when updating or duplicating the block; each language's content has its own draft revision.

Parametri

block_idstring

Block to read or edit.

Payload di risposta

id
string
obbligatorio
name
string
obbligatorio

Name for people choosing the block, such as when linking it into a template.

description
string

Optional notes for people maintaining the block. Omitted when empty.

source_language
string
obbligatorio

A language tag in BCP-47 form, for example en or pt-BR.

revision
integer
obbligatorio

Metadata revision to send when editing or duplicating this block.

created_by
object
obbligatorio

Who created the block. A duplicate is created by whoever duplicated it.

Mostra attributi secondari
archived_at
string

Present when the block is archived. Retained published content remains readable.

created_at
string
obbligatorio
updated_at
string
obbligatorio

Continua con la documentazione, le guide e gli esempi per questo argomento.