Kasutajagruppide API
Kasutajagrupid võimaldavad grupeerida kasutajaid loogilistesse rühmadesse, et lihtsustada omanike ja õiguste haldamist Kordoni ressurssidel.
POST /settings/user-groups/
Section titled “POST /settings/user-groups/”Uue kasutajagrupi loomine.
| Väli | Tüüp | Kohustuslik | Kirjeldus |
|---|---|---|---|
name | string | Jah | Kasutajagrupi nimi. |
description | string | Ei | Kasutajagrupi kirjeldus. |
color | string | Ei | Grupi sildi HEX värvikood (nt #5CDBD3). |
curl --location 'https://SINU_KORDONI_DOMEEN/api/v1/settings/user-groups/' \--header 'Content-Type: application/json' \--header 'Authorization: Bearer SINU_VÕTI' \--data '{ "user_group": { "name": "Turvameeskond", "description": "Infoturbe meeskonna liikmed", "color": "#5CDBD3" }}'Vastuse näide:
Staatus 200
{ "data": { "id": "c1d2e3f4-a5b6-7890-cdef-123456789abc", "name": "Turvameeskond", "description": "Infoturbe meeskonna liikmed", "color": "#5CDBD3", "active": true, "kind": "regular", "member_count": 0, "members": [], "permissions": { "update": true, "destroy": false, "connect": true, "changelog": true, "can_edit": true, "can_delete": false, "can_add_members": true, "can_remove_members": true } }}GET /settings/user-groups/
Section titled “GET /settings/user-groups/”Kõikide kasutajagruppide nimekiri. Lisa ?include_members=true, et saada koos iga grupi täielik liikmete nimekiri.
curl --location 'https://SINU_KORDONI_DOMEEN/api/v1/settings/user-groups/?include_members=true' \--header 'Content-Type: application/json' \--header 'Authorization: Bearer SINU_VÕTI'Vastuse näide:
Staatus 200
{ "data": [ { "id": "c1d2e3f4-a5b6-7890-cdef-123456789abc", "name": "Turvameeskond", "description": "Infoturbe meeskonna liikmed", "color": "#5CDBD3", "active": true, "kind": "regular", "member_count": 1, "members": [ { "id": "98dcb717-al70-4c89-8246-0bb026wc215b", "name": "Anna Smith", "active": true, "role": "admin", "picture": null } ], "permissions": { "update": true, "destroy": false, "connect": true, "changelog": true, "can_edit": true, "can_delete": false, "can_add_members": true, "can_remove_members": true } }, { "id": "d2e3f4a5-b6c7-8901-efab-234567890def", "name": "Vastavusmeeskond", "description": "Vastutavad regulatiivse vastavuse eest", "color": "#FF7A45", "active": true, "kind": "regular", "member_count": 0, "members": [], "permissions": { "update": true, "destroy": true, "connect": true, "changelog": true, "can_edit": true, "can_delete": true, "can_add_members": true, "can_remove_members": true } } ], "meta": { "page": 1, "per_page": 25, "total_count": 2 }}POST /settings/user-groups/:id/memberships
Section titled “POST /settings/user-groups/:id/memberships”Kasutaja lisamine kasutajagruppi.
| Väli | Tüüp | Kohustuslik | Kirjeldus |
|---|---|---|---|
user_id | string (UUID) | Jah | Gruppi lisatava kasutaja ID. |
curl --location 'https://SINU_KORDONI_DOMEEN/api/v1/settings/user-groups/GRUPI_ID/memberships' \--header 'Content-Type: application/json' \--header 'Authorization: Bearer SINU_VÕTI' \--data '{ "user_id": "44a2a59e-2ac4-47ea-a5fb-942107e690ef"}'Vastuse näide:
Staatus 200
{ "data": { "id": "76c0ac1d-04da-4485-b858-0518fec1d242", "active": true, "created_at": "2026-04-15T10:51:49+00:00", "updated_at": "2026-04-15T10:51:49+00:00" }, "meta": { "total_count": 2, "page": 1, "per_page": 10 }}