# Make a group of sites

> tidekeeper's API reference: https://tidekeeper.eu/docs/api/post-groups

`POST /api/v1/groups`

Make a group of sites.

## What to send

`GroupBody`: A group made, or changed: its name, its sites (by name or id) in place of what it had, or sites put in and taken out.

- `add` (list of string)
- `name` (string or null)
- `remove` (list of string)
- `sites` (list of string or null)

## The answer

201, `GroupView`: A workspace's own group of sites (doc/all-sites.md §3.3).

- `created_at` (string, needed): RFC 3339.
- `id` (string, needed)
- `made_by` (string, needed)
- `name` (string, needed)
- `sites` (list of string, needed): Its sites by name, those the caller may open, in the order they were put in.

## Asking

```sh
curl -X POST https://tidekeeper.eu/api/v1/groups \
    -H "Authorization: Bearer $TIDEKEEPER_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{}'
```