Skip to main content
PATCH
Update a tag

Authorizations

Authorization
string
header
required

Project-scoped secret API key (sk_…). Pass in the Authorization: Bearer <key> header. Grants access to the project the key was issued for.

Path Parameters

tagId
integer | null

Numeric tag identifier.

Example:

17

Body

application/json

Update an existing tag’s name.

name
string
required

Tag name.

Minimum string length: 1
Example:

"newsletter-2026-q2"

Response

The updated tag.

A simple label that can be applied to users, segments, lists, templates, and campaigns.

id
integer
required

Numeric tag identifier.

Example:

17

project_id
integer
required
name
string
required

Tag name. Stable label applied across users, segments, lists, templates, and campaigns.

Minimum string length: 1
Example:

"newsletter-2026-q2"

created_at
string | null
required
updated_at
string | null
required