Groups

Download OpenAPI specification:Download

Manage user groups

Create group

Create a group for your users

SecurityHTTP: bearer
Request
Request Body schema: application/json
name
required
string

Name of the group to create

description
string
custom_data
object

Group custom data object

Responses
201
409
post/v1/groups
Request samples
application/json
{
  • "name": "string",
  • "description": "string",
  • "custom_data": { }
}
Response samples
application/json
{
  • "result": {
    }
}

Get groups

Retrieve a list of all groups

SecurityHTTP: bearer
Responses
200
400
get/v1/groups
Request samples
curl -i -X GET \
  https://api.transmitsecurity.io/cis/v1/groups \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'
Response samples
application/json
{
  • "result": [
    ]
}

Get group by ID

Retrieve a group by ID

SecurityHTTP: bearer
Request
path Parameters
group_id
required
string

ID of the group to retrieve

Responses
200
404
get/v1/groups/{group_id}
Request samples
curl -i -X GET \
  'https://api.transmitsecurity.io/cis/v1/groups/{group_id}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'
Response samples
application/json
{
  • "result": {
    }
}

Update group

Update a group for your users

SecurityHTTP: bearer
Request
path Parameters
group_id
required
string

The ID of the group that should be updated

Request Body schema: application/json
name
string

Name of the group to update

description
string
custom_data
object

Group custom data object

Responses
200
400
404
put/v1/groups/{group_id}
Request samples
application/json
{
  • "name": "string",
  • "description": "string",
  • "custom_data": { }
}
Response samples
application/json
{
  • "result": {
    }
}

Delete group

Delete a group

SecurityHTTP: bearer
Request
path Parameters
group_id
required
string

ID of the group to delete

Responses
204

Group removed.

400
404
delete/v1/groups/{group_id}
Request samples
curl -i -X DELETE \
  'https://api.transmitsecurity.io/cis/v1/groups/{group_id}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'
Response samples
application/json
{
  • "message": "Bad request",
  • "error_code": 400
}

Add users to group

Add one or more users as members of a group

SecurityHTTP: bearer
Request
path Parameters
group_id
required
string

ID of the group to assign the users to

Request Body schema: application/json
user_ids
required
Array of strings

ID of the users to assign to the group

Responses
204

Assigned users to group.

400
404
post/v1/groups/{group_id}/members
Request samples
application/json
{
  • "user_ids": [
    ]
}
Response samples
application/json
{
  • "message": "Bad request",
  • "error_code": 400
}

Get group's users

Retrieve all users that are members of a specific group

SecurityHTTP: bearer
Request
path Parameters
group_id
required
string

ID of the group to retrieve users for

Responses
200
400
404
get/v1/groups/{group_id}/members
Request samples
curl -i -X GET \
  'https://api.transmitsecurity.io/cis/v1/groups/{group_id}/members' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'
Response samples
application/json
{
  • "result": [
    ]
}

Remove user from group

Remove a user from a group

SecurityHTTP: bearer
Request
path Parameters
group_id
required
string

Group ID

user_id
required
string

User ID

Responses
204

Removed user from group.

400
404
delete/v1/groups/{group_id}/members/{user_id}
Request samples
curl -i -X DELETE \
  'https://api.transmitsecurity.io/cis/v1/groups/{group_id}/members/{user_id}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'
Response samples
application/json
{
  • "message": "Bad request",
  • "error_code": 400
}