Sign inGet Started

Duplicate a reusable email block

POST
/v1/email/blocks/{block_id}/duplicate
// Requires email_management:write permission in the target workspace.
const source = await bird.email.blocks.get("ebl_01krdgeqcxet5s7t44vh8rt9mg");
const copy = await bird.email.blocks.duplicate(source.id, {
  revision: source.revision,
  name: "Legal footer (EU)",
});
console.log(copy.id);
Antwort201
{
  "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"
}

Copies every current draft language into a new unpublished block, with no publication history or translation-source references. Each language keeps its authoring mode. A change to the source block while copying returns a 409 conflict_error.

Parameter

block_idstring

Block to read or edit.

Anfrage-Nutzlast

revision
integer
erforderlich

Source metadata revision last read. A change while copying returns 409.

name
string
erforderlich

Name for the new block.

Antwort-Payload

id
string
erforderlich
name
string
erforderlich

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
erforderlich

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

revision
integer
erforderlich

Metadata revision to send when editing or duplicating this block.

created_by
object
erforderlich

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

Untergeordnete Attribute anzeigen
created_by.id
string
erforderlich

Actor identifier.

created_by.type
string
erforderlich

New 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_name
nullable string

The 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_at
string

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

created_at
string
erforderlich
updated_at
string
erforderlich

Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.