Groups

Add Users To Group

post

Create a new group.

Path parameters

group_idstring · uuidRequired

Body

emailsstring · email[]Required

Responses

201

Successful Response

application/json

404

Not found

422

Validation Error

application/json

post

HTTPcURLJavaScriptPython

POST /groups/{group_id}/users HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 29

{
  "emails": [
    "[email protected]"
  ]
}

{
  "name": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

Remove Users From Group

delete

Remove users from a group.

Path parameters

group_idstring · uuidRequired

Body

user_idsstring · uuid[]Required

Responses

201

Successful Response

application/json

404

Not found

422

Validation Error

application/json

delete

HTTPcURLJavaScriptPython

DELETE /groups/{group_id}/users HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 53

{
  "user_ids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

{
  "name": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

Read Groups

get

f Retrieve a list of groups.

Query parameters

workspace_idstring · uuidRequired

Responses

200

Successful Response

application/json

404

Not found

422

Validation Error

application/json

get

HTTPcURLJavaScriptPython

GET /groups?workspace_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Accept: */*

[
  {
    "name": "text",
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "group_type": "text",
    "user_count": 1
  }
]

Create New Group

post

Create a new group.

Query parameters

workspace_idstring · uuidRequired

Body

namestringRequired

emailsstring · email[]Required

Responses

201

Successful Response

application/json

404

Not found

422

Validation Error

application/json

post

HTTPcURLJavaScriptPython

POST /groups?workspace_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "name": "text",
  "emails": [
    "[email protected]"
  ]
}

{
  "name": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

Read Group

get

Get a specific group by ID.

Path parameters

group_idstring · uuidRequired

Responses

200

Successful Response

application/json

404

Not found

422

Validation Error

application/json

get

HTTPcURLJavaScriptPython

GET /groups/{group_id} HTTP/1.1
Host: 
Accept: */*

{
  "name": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "group_type": "text",
  "user_count": 1,
  "users": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "email": "text",
      "avatar_url": "text",
      "external_id": "text",
      "joined": "2025-08-11T20:24:30.675Z"
    }
  ]
}

Update Existing Group

put

Update a group's name.

Path parameters

group_idstring · uuidRequired

Query parameters

workspace_idstring · uuidRequired

Body

namestringRequired

Responses

200

Successful Response

application/json

404

Not found

422

Validation Error

application/json

put

HTTPcURLJavaScriptPython

PUT /groups/{group_id}?workspace_id=123e4567-e89b-12d3-a456-426614174000 HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "name": "text"
}

{
  "name": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000"
}

Delete Existing Group

delete

Delete a group by ID.

Path parameters

group_idstring · uuidRequired

Responses

200

Successful Response

application/json

Responseany

404

Not found

422

Validation Error

application/json

delete

HTTPcURLJavaScriptPython

DELETE /groups/{group_id} HTTP/1.1
Host: 
Accept: */*

No content