#Security
Use security endpoint to manage permissions and security settings in the system programmically. Permissions can be created and added to resource actions to define granular permission control of what users can do in the system
GET /security/permissiongroups Get all permission groups added to the system
[
{
"Uid": "45152869-bd24-4709-be09-6fca2f2e0f7d",
"Name": "Products"
},
{
"Uid": "e86d7b4b-8b53-459a-bb73-29fd99de44fb",
"Name": "Variants"
}
]Response status OK (200)
array : PermissionGroupModel
PermissionGroupModel
| Property name | Data type | Description |
|---|---|---|
| Uid | string |
Unique id of permission group |
| Name | string |
Name of permission group |
PUT /security/permissiongroups Update a permission group
Request parameters
| Property name | Parameter type | Data type | Description |
|---|---|---|---|
| model | body | object : PermissionGroupModel |
PermissionGroupModel
| Property name | Data type | Description |
|---|---|---|
| Uid | string |
Unique id of permission group |
| Name | string |
Name of permission group |
Response status OK (200)
No body message is returned
POST /security/permissiongroups Add permission group to system
Request parameters
| Property name | Parameter type | Data type | Description |
|---|---|---|---|
| model | body | object : PermissionGroupModel |
PermissionGroupModel
| Property name | Data type | Description |
|---|---|---|
| Uid | string |
Unique id of permission group |
| Name | string |
Name of permission group |
Response status OK (200)
No body message is returned
GET /security/permissiongroups/{uid} Get a specific permission group
{
"Uid": "50236b11-b888-46ed-9333-6b2c5a3cf9fc",
"Name": "Products"
}Request parameters
| Property name | Parameter type | Data type | Description |
|---|---|---|---|
| uid | path | string |
Response status OK (200)
object : PermissionGroupModel
PermissionGroupModel
| Property name | Data type | Description |
|---|---|---|
| Uid | string |
Unique id of permission group |
| Name | string |
Name of permission group |
DELETE /security/permissiongroups/{uid} Delete a permission group
Request parameters
| Property name | Parameter type | Data type | Description |
|---|---|---|---|
| uid | path | string |
the Unique id of the permission group |
Response status OK (200)
No body message is returned
GET /security/permissions Get all permissions added to the system
[
{
"Uid": "cd1667f8-13e2-48f1-b6b0-13b48c830d2d",
"PermissionGroupUid": "c14257a3-b929-48c3-bcd3-a4cd3a84385a",
"PermissionName": "Create products",
"Description": "Permission required by users to be able to create new products"
},
{
"Uid": "d2ce46d5-fd31-4457-88aa-407a7e28ad0b",
"PermissionGroupUid": "c14257a3-b929-48c3-bcd3-a4cd3a84385a",
"PermissionName": "Update products",
"Description": "Permission required by users to be able to update products"
}
]Response status OK (200)
array : PermissionModel
PermissionModel
| Property name | Data type | Description |
|---|---|---|
| Uid | string |
Unique id of permission |
| PermissionGroupUid | string |
Uid of group to place permission in |
| PermissionName | string |
Name of permission |
| Description | string |
Description of permission |
PUT /security/permissions Update a permission
{
"Uid": "64a8bbd8-b9c3-405c-a0fa-40a56cb80871",
"PermissionGroupUid": "2c6199f4-94bb-4cb4-a932-45ec2adb158d",
"PermissionName": "Manage colors",
"Description": "Allows users to manage values in the colors global list"
}Request parameters
| Property name | Parameter type | Data type | Description |
|---|---|---|---|
| model | body | object : PermissionModel |
PermissionModel
| Property name | Data type | Description |
|---|---|---|
| Uid | string |
Unique id of permission |
| PermissionGroupUid | string |
Uid of group to place permission in |
| PermissionName | string |
Name of permission |
| Description | string |
Description of permission |
Response status OK (200)
No body message is returned
POST /security/permissions Add permission to system
{
"Uid": "3fe25e1a-5b45-42a0-b1be-368ce6903843",
"PermissionGroupUid": "a666aac6-93b0-41f6-a3e6-e850bbd3cef7",
"PermissionName": "Manage colors",
"Description": "Allows users to manage values in the colors global list"
}Request parameters
| Property name | Parameter type | Data type | Description |
|---|---|---|---|
| model | body | object : PermissionModel |
PermissionModel
| Property name | Data type | Description |
|---|---|---|
| Uid | string |
Unique id of permission |
| PermissionGroupUid | string |
Uid of group to place permission in |
| PermissionName | string |
Name of permission |
| Description | string |
Description of permission |
Response status OK (200)
No body message is returned
GET /security/permissions/{uid} Get a specific permission
{
"Uid": "3552ccd8-20ce-49c7-9d9c-9b970e656d05",
"PermissionGroupUid": "95867bbd-5f7b-4a65-bd2b-d15564bccae5",
"PermissionName": "Create products",
"Description": "Permission required by users to be able to create new products"
}Request parameters
| Property name | Parameter type | Data type | Description |
|---|---|---|---|
| uid | path | string |
Response status OK (200)
object : PermissionModel
PermissionModel
| Property name | Data type | Description |
|---|---|---|
| Uid | string |
Unique id of permission |
| PermissionGroupUid | string |
Uid of group to place permission in |
| PermissionName | string |
Name of permission |
| Description | string |
Description of permission |
DELETE /security/permissions/{uid} Delete a permission
Request parameters
| Property name | Parameter type | Data type | Description |
|---|---|---|---|
| uid | path | string |
the Unique id of the permission |
Response status OK (200)
No body message is returned