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);
Risposta201
{
  "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.

Parametri

block_idstring

Block to read or edit.

Payload della richiesta

revision
integer
obbligatorio

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

name
string
obbligatorio

Name for the new block.

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
created_by.id
string
obbligatorio

Actor identifier.

created_by.type
string
obbligatorio

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
obbligatorio
updated_at
string
obbligatorio

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