- 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 businessesGET
- Search businessesGET
- Search businesses by name or extra dataGET
- Export businessesGET
- Get a businessGET
- Create a businessPOST
- Import businesses from CSVPOST
- Update a businessPATCH
- Delete a businessDELETE
- 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 users
- Create a KIO user
- Get a KIO user
- Update a KIO user
- Activate or deactivate a KIO user
- Delete a KIO user
- Generate a session token for a user
- Export KIO users
- Search active KIO users by name
- Search KIO users
- Look up an employee in SuccessFactors
- Import KIO user updates from CSV
- External Users
- Send App NotificationPOST
- Events LocationsGET
- Fetch WiresGET
- Create Business Temporary SecretPOST
- Schemas
Create a business user role
QA Environment
https://qa-api.kiolinkapp.com
QA Environment
https://qa-api.kiolinkapp.com
POST
https://qa-api.kiolinkapp.com
Business Roles
Last modified:2026-10-05 20:37:26
Maintainer:Not configured
Required Permission(s):business-roles-create
name or slug) and duplicate slugs are returned as HTTP 500.business-roles-create permission.Request
Authorization
API Key
Add parameter in header
authorization
Example:
authorization: ********************or
Body Params application/jsonRequired
Example
{
"name": "Operador",
"slug": "operador",
"permissions": [
"65f1c2a9e4b0a1b2c3d4e5f9"
],
"show_in_releases": true
}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/businessroles' \
--header 'authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"name": "Operador",
"slug": "operador",
"permissions": [
"65f1c2a9e4b0a1b2c3d4e5f9"
],
"show_in_releases": true
}'Responses
🟢201Role created
application/json
Bodyapplication/json
Example
{
"_id": "65f1c2a9e4b0a1b2c3d4e5b3",
"name": "Operador",
"slug": "operador",
"permissions": [
"65f1c2a9e4b0a1b2c3d4e5f9"
],
"show_in_releases": true,
"__v": 0
}🟠401The session token expired
🟠403Not authenticated (missing/invalid token, inactive user), or
🔴500A required field is missing, the slug is taken, or another e
Modified at 2026-10-05 20:37:26