v1

latestOpenAPI 3.0.12026-07-24210349345.4 KB

Topics

Update topic

Updates an existing preference center topic. Note: hideFromUi cannot be changed after creation, so SMART campaign topics remain hidden from the UI.

put/preference-center/api/v1/topics

Request body

idstring uuid required

Unique identifier of the topic to update

namestring required

Display name of the topic (must be unique within brand group)

descriptionstring required

Description of the topic

brandGroupIdstring uuid required

Brand group this topic belongs to (must exist)

Response

Topic updated successfully.

idstring uuid

Unique identifier of the topic (set by server on create)

namestring

Display name of the topic

descriptionstring

Description of the topic

parentIdstring uuid nullable

Parent topic ID for hierarchical topics

orderinteger

Display order in the preference center

brandGroupIdstring uuid

Brand group this topic belongs to

createdAtstring date-time nullable

Set by server

createdBystring nullable

Set by server from auth context

updatedAtstring date-time nullable

Set by server

updatedBystring nullable

Set by server from auth context

hideFromUiboolean nullable

When true, topic is hidden from the preference center UI (e.g. SMART campaign topics). Cannot be changed after creation.