Path Parameters
Workspace ID where the role will be created
Body
application/json
curl --request POST \
--url http://sandbox.mintlify.com/api/v1/hotel/workspaces/{workspaceId}/role \
--header 'Content-Type: application/json' \
--header 'x-client-key: <api-key>' \
--header 'x-client-secret: <api-key>' \
--data '{
"title": "New Role Title",
"description": "New Role test description",
"permissions": [
"dbf2e476-c880-4f1c-9ac6-a44bc3c0c9a7",
"7790c9eb-8d55-4fe0-a52d-2e5e769e9588"
],
"users": [
"a437857a-463f-4ab7-997e-0e7b98e2b779",
"08c25f22-c894-4d9d-bba2-ced36b8191bd"
],
"reportTo": "43bc03d0-e0c5-41a1-bc13-2d232a40a728",
"homepage": {
"mobile": "DEFAULT",
"web": "DEFAULT",
"dashboard": {}
}
}'{
"data": {
"createdAt": "2025-06-22T11:38:55.045Z",
"updatedAt": "2025-06-22T11:38:55.045Z",
"id": "198a9961-c365-46d4-8962-7f9720f21fae",
"isActive": true,
"order": 1,
"title": "New Role Title",
"description": "New Role test description",
"editable": true,
"ReportTo": "43bc03d0-e0c5-41a1-bc13-2d232a40a728",
"homepage": {
"mobile": "DEFAULT",
"web": "DEFAULT",
"dashboard": {}
},
"HotelId": "cb363f7e-c52a-4478-911d-f6a6f791090e",
"CreatedBy": "dfea8b8a-5b22-4668-b68d-dc641eb3a101",
"UpdatedBy": "dfea8b8a-5b22-4668-b68d-dc641eb3a101",
"deletedAt": null
},
"meta": {}
}Creates a new role in the specified workspace
curl --request POST \
--url http://sandbox.mintlify.com/api/v1/hotel/workspaces/{workspaceId}/role \
--header 'Content-Type: application/json' \
--header 'x-client-key: <api-key>' \
--header 'x-client-secret: <api-key>' \
--data '{
"title": "New Role Title",
"description": "New Role test description",
"permissions": [
"dbf2e476-c880-4f1c-9ac6-a44bc3c0c9a7",
"7790c9eb-8d55-4fe0-a52d-2e5e769e9588"
],
"users": [
"a437857a-463f-4ab7-997e-0e7b98e2b779",
"08c25f22-c894-4d9d-bba2-ced36b8191bd"
],
"reportTo": "43bc03d0-e0c5-41a1-bc13-2d232a40a728",
"homepage": {
"mobile": "DEFAULT",
"web": "DEFAULT",
"dashboard": {}
}
}'{
"data": {
"createdAt": "2025-06-22T11:38:55.045Z",
"updatedAt": "2025-06-22T11:38:55.045Z",
"id": "198a9961-c365-46d4-8962-7f9720f21fae",
"isActive": true,
"order": 1,
"title": "New Role Title",
"description": "New Role test description",
"editable": true,
"ReportTo": "43bc03d0-e0c5-41a1-bc13-2d232a40a728",
"homepage": {
"mobile": "DEFAULT",
"web": "DEFAULT",
"dashboard": {}
},
"HotelId": "cb363f7e-c52a-4478-911d-f6a6f791090e",
"CreatedBy": "dfea8b8a-5b22-4668-b68d-dc641eb3a101",
"UpdatedBy": "dfea8b8a-5b22-4668-b68d-dc641eb3a101",
"deletedAt": null
},
"meta": {}
}Workspace ID where the role will be created