Skip to main content
Create a group dimension, a grouping axis, and return it. A dimension holds no members itself: create the axis here, then call create_group once per value it takes (‘Country’ → ‘France’, ‘Spain’). The new dimension is added as a picklist field to every reporting table, so reports can break down by it straight away. A key another dimension already uses, archived ones included, is refused. Every write is recorded in the audit trail as the Qobra MCP agent.

​
Parameters

Body

​
string
required
Display name of the grouping axis, e.g. ‘Country’.
​
string
required
Stable key, unique among dimensions (archived ones included): lowercase letters, digits and _ only, stored as sent (‘sales_region’).
​
string
Free-text note about what the axis groups.

​
Response

Body

​
object
The dimension as it now exists — the same shape list_group_dimensions returns, so the id can be reused straight away.