Tags
Label your own posts (a hook style, a format, a campaign) and compare them: tags filter GET /posts and the analytics, and GET /analytics/tags shows how each tag did against your normal per channel. Tags never go to a platform.
Create a tag
At most 200 tags per workspace. A name is unique in the workspace (case-insensitive).
Create a tag › Request Body
nameUnique in the workspace (case-insensitive).
colorOmit on create to get the next colour of the palette.
Create a tag › Responses
The new tag
A workspace's own label for its posts (for example a hook style or a format), to filter and compare posts in Analytics. Never sent to a platform.
Update a tag
Rename or recolour. A key you leave out keeps its value. Posts keep the tag.
path Parameters
idUpdate a tag › Request Body
nameUnique in the workspace (case-insensitive).
colorOmit on create to get the next colour of the palette.
Update a tag › Responses
The updated tag
A workspace's own label for its posts (for example a hook style or a format), to filter and compare posts in Analytics. Never sent to a platform.
Tag posts in bulk
Add, remove or replace the tags of up to 500 posts at once, published ones included (tags never go to a platform). add, remove and set take tag ids or names; a new name in add or set becomes a tag. set replaces a post's tags, add and remove change only the tags you name. Post ids that are not posts of this workspace come back in not_found.
Tag posts in bulk › Responses
The posts with their tags now