Get a reusable email block
/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);# Requires email_management:read permission in the target workspace.
block = client.email.blocks.get("ebl_01krdgeqcxet5s7t44vh8rt9mg")
print(block.name, block.revision, block.archived_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)
}
block, err := client.Email.Blocks.Get(context.Background(), "ebl_01krdgeqcxet5s7t44vh8rt9mg")
if err != nil {
log.Fatal(err)
}
fmt.Println(block.Name, block.Revision)// Requires email_management:read permission in the target workspace.
$block = $bird->email->blocks->get('ebl_01krdgeqcxet5s7t44vh8rt9mg');
echo $block->getName(), ' ', $block->getRevision();bird email blocks get <block-id>curl -X GET "https://us1.platform.bird.com/v1/email/blocks/{block_id}" \
-H "Authorization: Bearer $TOKEN"{
"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.
Parâmetros
block_idstringBlock to read or edit.
Payload de resposta
idnameName for people choosing the block, such as when linking it into a template.
descriptionOptional notes for people maintaining the block. Omitted when empty.
source_languageA language tag in BCP-47 form, for example en or pt-BR.
revisionMetadata revision to send when editing or duplicating this block.
created_byWho created the block. A duplicate is created by whoever duplicated it.
Mostrar atributos secundários
created_by.idActor identifier.
created_by.typeNew actor types may be added. Treat unrecognized values as future types, not errors.
user: a member's own session.api_key: a workspace API key.oauth_token: a token issued to a caller on a member's behalf.system: an action we perform without a customer actor.sso: an organization's SSO connection.service_account: a workspace's connected Integration acting with no member behind it.automation: an automation execution in your workspace.
Possible values (may grow over time): user, api_key, oauth_token, system, sso, service_account, automation
created_by.display_nameThe label the actor is shown under: typically a member's name or email address, or the API key's name. Null when it could not be resolved.
archived_atPresent when the block is archived. Retained published content remains readable.
created_atupdated_atRecursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico.