Skip to main content
PUT
Set a post's analytics tags

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization code + PKCE (S256). Tokens are tenant-bound (company_id) and scoped. Discover endpoints via /.well-known/oauth-authorization-server.

Path Parameters

id
string
required

The id.

Body

application/json

Body for setting, adding or removing a post's analytics tags. The route reads only tags and operation. The two coercions above combine into a destructive default worth stating plainly: because an unrecognised operation becomes replace and a missing or non-array tags becomes an empty list, a request that omits both - or that misspells the operation, including a capitalised Remove - returns 200 and clears every tag on the post. Send operation exactly as one of the enum values, in lower case, and always send tags.

tags
string[]
required

Tag strings to apply (free-form analytics labels). A non-array value is coerced to an empty list by the route.

operation
enum<string>
default:replace

How to apply the tags. Any value other than "add" or "remove" is treated as "replace".

Available options:
replace,
add,
remove

Response

The post's resulting analytics tags and write metadata.

data
object
required