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

# POST /groups/{group_namespace}/{group_name}

`POST /groups/{group_namespace}/{group_name}`

## 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}/{group_name}`
- Auth: one of:
  - HTTP basic
  - API key in header `X-TILEDB-REST-API-KEY`

Retrieves the contents of a group

## Request body

- GroupContentsRetrievalRequest: Request the contents of a group
  - `config` TileDBConfig: TileDB config used for interaction with the embedded library
    - `entries` object[]
      - `key` string
      - `value` string

## Response `200`

group created successfully

- GroupContentsRetrievalResponse: Object including a page of members of a group and pagination metadata
  - `members` GroupMember[]: Groups members
    - `name` string: The name of the member
    - `uri` string: The uri of the member
    - `type` 'GROUP' | 'ARRAY': File types that can be included in groups
  - `metadata` Metadata: user's TileDB metadata
    - `entries` MetadataEntry[]: List of metadata entries
      - `key` string
      - `type` string
      - `valueNum` integer
      - `value` unknown
      - `del` boolean

## 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/:group_name/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)