---
title: "POST /groups/{group_namespace}"
method: POST
path: "/groups/{group_namespace}"
tags: ["groups"]
---

# POST /groups/{group_namespace}

`POST /groups/{group_namespace}`

## Request

- Base URL: `/v2` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v2/groups/{group_namespace}`
- Auth: one of:
  - HTTP basic
  - API key in header `X-TILEDB-REST-API-KEY`

Creates an empty group

## Request body

- GroupCreationRequest: information for creating a new group with the passed configuration
  - `config` TileDBConfig: TileDB config used for interaction with the embedded library
    - `entries` object[]
      - `key` string
      - `value` string
  - `group_details` object, required: Initial attributes for the creation of a group.
    - `description` string: A human readable description of the contents of the group.
    - `name` string: The name of the group. If must be unique within the group.
    - `uri` string: uri of group.
    - `logo` string: logo (base64 encoded) for the group. Optional
    - `tags` string[]: optional tags for groups.
    - `license_id` string: License identifier from SPDX License List or Custom.
    - `license_text` string: License text

## Response `201`

group created successfully

- GroupCreationResponse: Information of the created group
  - `id` string: The UUID of the created Group
  - `name` string: The name of the created Group
  - `tiledb_uri` string: TileDB URI for access

## Other responses

- `502`: Bad Gateway
- `default`: error response

## Changes

- **2023-02-17** (v2) `1dc25429ac96`: 1 info
  - added the non-success response with the status `502`
- **2023-02-17** (v2) `cb4897d3247d`: 1 info
  - removed the non-success response with the status `502`
- **2022-11-03** (v2) `dd919c4fb5a3`: 1 info
  - added the non-success response with the status `502`
- **2022-11-03** (v2) `38cbb9a7a8ed`: 1 info
  - removed the non-success response with the status `502`
- **2022-10-21** (v2) `35603092a7df`: 1 info
  - added the non-success response with the status `502`

[Operation history](https://skmtc.dev/tiledb/apis/tiledb-storage-platform-api/changes/groups/:group_namespace/post.md)

---

[API](https://skmtc.dev/tiledb/apis/tiledb-storage-platform-api.md) - [All operations](https://skmtc.dev/tiledb/apis/tiledb-storage-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tiledb/apis/tiledb-storage-platform-api/revisions/f9cbeb4407a5?raw)