Skip to main content
POST
Bulk update 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.

Body

application/json

At least one of selectedPostIds, query, or filters is required, otherwise the route returns 400 (refusing to tag the entire company by default).

operation
enum<string>
required

How to apply the tags across all matched posts.

Available options:
add,
remove,
replace
tags
string[]
required

Tag strings to apply (at least one after sanitization).

Minimum array length: 1
selectedPostIds
string[]

Explicit post ids to target.

query
string

Free-text search over post title/creator/contractorName to select targets. Pass "*" to mean all posts.

filters
string

Additional Typesense filter_by expression to narrow targets.

Response

Per-post results and errors for the bulk tag operation.

data
object
required