- Auth
- Application Content
- Businesses
- Overview
- Business Users
- Overview
- List business users by business
- List a business's users
- Create a business user
- Get a business user
- Update a business user
- Upload a business user's avatar
- Delete a business user's avatar
- Deactivate business users
- Search business users
- Search a business's users
- Send a password reset email to a business user
- Reset a business user's daily sign-in code limits
- Toggle a business user's two-factor authentication
- Import business users from CSV
- Export all business users
- Set whether I receive releases
- Set whether I receive alerts
- Request the deletion of my account
- Business Roles
- Business Permissions
- Business Consoles
- Business Devices
- Business Racks
- Business Locations
- Business Reports
- List businesses
- Search businesses
- Search businesses by name or extra data
- Export businesses
- Get a business
- Create a business
- Import businesses from CSV
- Update a business
- Delete a business
- Banned Devices
- Data Centers
- Intake Forms
- List intake form reponses
- Get an intake form's response
- Get an intake form's response license file
- Get an intake form's response identification file
- Download intake form responses report
- Create an intake form's response
- Upload a license file to an intake form's response
- Upload an identification file to an intake form's response
- Update an intake form's response
- Delete an intake form's response
- Users
- Overview
- Permissions
- Roles
- User Groups
- List KIO usersGET
- Create a KIO userPOST
- Get a KIO userGET
- Update a KIO userPATCH
- Activate or deactivate a KIO userPATCH
- Delete a KIO userDELETE
- Generate a session token for a userGET
- Export KIO usersGET
- Search active KIO users by nameGET
- Search KIO usersGET
- Look up an employee in SuccessFactorsGET
- Import KIO user updates from CSVPATCH
- External Users
- Send App NotificationPOST
- Events LocationsGET
- Fetch WiresGET
- Create Business Temporary SecretPOST
- Schemas
Create a KIO user role
QA Environment
https://qa-api.kiolinkapp.com
QA Environment
https://qa-api.kiolinkapp.com
POST
https://qa-api.kiolinkapp.com
Roles
Last modified:2026-10-05 20:16:57
Maintainer:Not configured
Required Permission(s):users-roles-create
slug when sent, otherwise from name (lowercased and hyphenated). The change is recorded in the permissions audit log.users-roles-create permission.Request
Authorization
API Key
Add parameter in header
authorization
Example:
authorization: ********************or
Body Params application/jsonRequired
Example
{
"name": "Seguridad",
"permissions": [
"65f1c2a9e4b0a1b2c3d4e5f9",
"65f1c2a9e4b0a1b2c3d4e5fa"
]
}Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://qa-api.kiolinkapp.com/v1/roles' \
--header 'authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"name": "Seguridad",
"permissions": [
"65f1c2a9e4b0a1b2c3d4e5f9",
"65f1c2a9e4b0a1b2c3d4e5fa"
]
}'Responses
🟢200Role created
application/json
Bodyapplication/json
Example
{
"_id": "65f1c2a9e4b0a1b2c3d4e5bb",
"name": "Seguridad",
"slug": "seguridad",
"permissions": [
"65f1c2a9e4b0a1b2c3d4e5f9",
"65f1c2a9e4b0a1b2c3d4e5fa"
],
"__v": 0
}🟠400`name` is missing
🟠401The session token expired
🟠403Not authenticated (missing/invalid token, inactive user), or
🔴500Unexpected error (e
Modified at 2026-10-05 20:16:57