curl -i -X GET \ https://api.transmitsecurity.io/cis/v1/roles \ -H 'Authorization: Bearer <YOUR_JWT_HERE>'
{- "result": [
- {
- "role_id": "string",
- "role_name": "string",
- "permissions": [
- "string"
]
}
]
}
Retrieve role assignments for entities. For example, you can get all roles assigned to users, all roles assigned to a specific group, or all assignments of a specific role to users.
curl -i -X GET \ 'https://api.transmitsecurity.io/cis/v1/roles/assignments?entity_ids=string&entity_type=User&role_ids=string' \ -H 'Authorization: Bearer <YOUR_JWT_HERE>'
{- "result": [
- {
- "app_id": "string",
- "entity_id": "string",
- "entity_type": "User",
- "assignments": [
- {
- "role_id": "string",
- "assigned_at": "2019-08-24T14:15:22Z",
- "assigned_by": "string",
- "assigned_by_email": "string"
}
]
}
]
}
Retrieve roles for a user or group
The role has been successfully fetched.
curl -i -X GET \ 'https://api.transmitsecurity.io/cis/v1/roles/assignments/{entity_id}' \ -H 'Authorization: Bearer <YOUR_JWT_HERE>'
{- "result": [
- {
- "role_id": "string",
- "role_name": "string",
- "permissions": [
- "string"
]
}
]
}
curl -i -X GET \ 'https://api.transmitsecurity.io/cis/v1/roles/{role_id}' \ -H 'Authorization: Bearer <YOUR_JWT_HERE>'
{- "result": {
- "role_id": "string",
- "role_name": "string",
- "permissions": [
- "string"
]
}
}
{- "role_name": "string"
}
{- "result": {
- "role_id": "string",
- "role_name": "string",
- "permissions": [
- "string"
]
}
}
curl -i -X DELETE \ 'https://api.transmitsecurity.io/cis/v1/roles/{role_id}' \ -H 'Authorization: Bearer <YOUR_JWT_HERE>'
{- "message": "Bad request",
- "error_code": 400
}
Assign users or groups to a role
{- "entity_ids": [
- "string"
], - "entity_type": "User"
}
{- "message": "Bad request",
- "error_code": 400
}
Delete user or group assignment from a role
curl -i -X DELETE \ 'https://api.transmitsecurity.io/cis/v1/roles/{role_id}/assignments/{entity_id}' \ -H 'Authorization: Bearer <YOUR_JWT_HERE>'
{- "message": "Bad request",
- "error_code": 400
}
Update permissions associated with a role
{- "permissions": [
- "string"
]
}
{- "role_id": "string",
- "role_name": "string",
- "permissions": [
- "string"
]
}