Skip to main content
POST
Create a new entity group

Headers

x-project-id
string
required

Project ID to specify the project context

Body

application/json
name
string
required

Group name

Example:

"Premium Brands"

kind
enum<string>

What this container is. "group" is a top-level group; "division" can sit under a group or stand alone. Immutable after creation. Defaults to "group".

Available options:
group,
division
parentId
string<uuid>

Parent group for a division. Only divisions can have a parent, and the parent must be a group. Omit to create a top-level group or a standalone division.

Example:

"018f3a2b-7c4d-7e91-b3f5-2a6c8d0e1f42"

Response

id
string<uuid>
required
kind
enum<string>
required

What this container is: a top-level "group" or a "division". Immutable.

Available options:
group,
division
name
string
required
slug
string
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
parent
string<uuid> | null

Parent group ID. Set only on divisions that belong to a group; null on top-level groups and standalone divisions.