Group
The Group API allows you to manage user groups within your Decube organization. Use these endpoints to create groups, add or remove users from groups, retrieve group details, and list all groups. This is essential for managing access control and permissions at scale.
Add user to group.
Body
user_idstringRequired
group_idintegerRequired
Responses
200
Successful Response
application/json
Responseany
422
Validation Error
application/json
post
POST /api/v1/data/acl/group/add_user HTTP/1.1
Host: connect.<REGION>.decube.io
Content-Type: application/json
Accept: */*
Content-Length: 31
{
"user_id": "text",
"group_id": 1
}
No content
Remove user from group.
Body
user_idstringRequired
group_idintegerRequired
Responses
200
Successful Response
application/json
Responseany
422
Validation Error
application/json
post
POST /api/v1/data/acl/group/remove_user HTTP/1.1
Host: connect.<REGION>.decube.io
Content-Type: application/json
Accept: */*
Content-Length: 31
{
"user_id": "text",
"group_id": 1
}
No content
Fetch group based on group id.
Query parameters
group_idintegerRequired
Id of group
Responses
200
Successful Response
application/json
422
Validation Error
application/json
get
GET /api/v1/data/acl/group?group_id=1 HTTP/1.1
Host: connect.<REGION>.decube.io
Accept: */*
{
"id": 1,
"name": "text",
"description": "text",
"owner": true,
"users": [
"text"
],
"policies": [
1
]
}
List all groups available in the account.
Query parameters
pageinteger · min: 1OptionalDefault:
1
page_sizeinteger · min: 1 · max: 100OptionalDefault:
10
Responses
200
Successful Response
application/json
422
Validation Error
application/json
get
GET /api/v1/data/acl/group/list HTTP/1.1
Host: connect.<REGION>.decube.io
Accept: */*
[
{
"id": 1,
"name": "text",
"description": "text",
"owner": true,
"users": [
"text"
],
"policies": [
1
]
}
]
Last updated