---
title: "Create"
method: POST
path: "/groups"
tags: ["Groups"]
---

# Create

`POST /groups`

## Request

- Base URL: `https://api.mirurobotics.com/beta`
- URL: `https://api.mirurobotics.com/beta/groups`
- Auth: API key in header `X-API-Key`

Create a new group.

## Query parameters

- `expand` GroupExpansion[]

## Request body

- CreateGroupRequest
  - `name` string, required: The name of the group.
  - `parent_id` string, nullable: ID of the parent group. Omit or set to null to create a top-level group.

## Response `200`

Successfully created the group.

- Group
  - `object` 'group', required: The object type, which is always `group`.
  - `id` string, required: ID of the group.
  - `name` string, required: Name of the group.
  - `parent_id` string, nullable, required: ID of the parent group. Null for top-level groups.
  - `created_at` string, date-time, required: Timestamp of when the group was created.
  - `updated_at` string, date-time, required: Timestamp of when the group was last updated.
  - `parent` Group (recursive)

---

[API](https://skmtc.dev/mirurobotics/apis/miru-platform-api.md) - [All operations](https://skmtc.dev/mirurobotics/apis/miru-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mirurobotics/apis/miru-platform-api/revisions/80ee5be70cc3?raw)