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);
响应201
{
  "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.

参数

block_idstring

Block to read or edit.

请求载荷

revision
integer
必填

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

name
string
必填

Name for the new block.

响应载荷

id
string
必填
name
string
必填

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
必填

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

revision
integer
必填

Metadata revision to send when editing or duplicating this block.

created_by
object
必填

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

显示子属性
archived_at
string

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

created_at
string
必填
updated_at
string
必填