Sign in
Preference Sections

Create Preference Section

Create a preference section in your workspace. The section id is generated and returned. Topics are created inside a section via POST /preferences/sections/{section_id}/topics.

post/preferences/sections

Request body

namestring required

Human-readable name for the section.

routing_optionsChannelClassification[] nullable

Default channels for the section. Defaults to empty if omitted.

has_custom_routingboolean nullable

Whether the section defines custom routing for its topics.

Response

Created

idstring required

The preference section id.

namestring required

Human-readable name.

routing_optionsChannelClassification[] required

Default channels for the section. May be empty.

has_custom_routingboolean required

Whether the section defines custom routing for its topics.

createdstring required

ISO-8601 timestamp of when the section was created.

creatorstring nullable

Id of the creator.

updatedstring nullable

ISO-8601 timestamp of the last update.

updaterstring nullable

Id of the last updater.

Changes