Skip to main content
PATCH
/
workers
/
{id}
/
permissions
Edit Worker Permissions
curl --request PATCH \
  --url https://api.roostedhr.com/api/1_12/workers/{id}/permissions \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "permissions": {
    "print_timesheets": 0,
    "create_edit_jobs": 0,
    "create_edit_all_jobs": 0,
    "text_release": 0,
    "gridview": 0,
    "configuration": 0,
    "reports": 0,
    "add_edit_workers": 0,
    "view_company_info": 0,
    "add_edit_locations": 0,
    "time_off_manager": 0,
    "request_manager": 0,
    "modify_skillsets": 0,
    "modify_permissions": 0,
    "approve_punches": 0,
    "modify_punches": 0,
    "timekeeping_manager": 0,
    "communications_module": 0,
    "view_recent_reviews": 0,
    "view_edit_wages": 0,
    "create_edit_clients": 0,
    "create_group_chats": 0,
    "view_edit_all_chats": 0,
    "view_bg_check_results": 0,
    "request_bg_checks": 0,
    "exporting": 0,
    "add_edit_workers_jobs": 0,
    "create_job": 0,
    "view_worker_profile_dialog": 0
  }
}
'
{ "admin": 0, "owner": 0, "permissions": { "print_timesheets": 0, "create_edit_jobs": 0, "create_edit_all_jobs": 0, "text_release": 0, "gridview": 0, "configuration": 0, "reports": 0, "add_edit_workers": 0, "view_company_info": 0, "add_edit_locations": 0, "time_off_manager": 0, "request_manager": 0, "modify_skillsets": 0, "modify_permissions": 0, "approve_punches": 0, "modify_punches": 0, "timekeeping_manager": 0, "communications_module": 0, "view_recent_reviews": 0, "view_edit_wages": 0, "create_edit_clients": 0, "create_group_chats": 0, "view_edit_all_chats": 0, "view_bg_check_results": 0, "request_bg_checks": 0, "exporting": 0, "add_edit_workers_jobs": 0, "create_job": 0, "view_worker_profile_dialog": 0 } }
This is a partial update — only include the permissions you want to change. Omitted permissions remain unchanged.
The admin and owner flags cannot be modified through this endpoint. Only the granular permissions within the permissions object are updatable.

Authorizations

​
X-API-KEY
string
header
required

Path Parameters

​
id
string
required

Worker ID

Body

application/json

Only the permissions object can be updated. Include only the permission flags you want to change.

​
permissions
object

Granular module-level permission flags. All values are 1 (enabled) or 0 (disabled).

Response

Permissions updated successfully

Worker permission flags including admin/owner status and granular module-level permissions.

​
admin
enum<integer>

Whether the worker has admin privileges. 1 = admin, 0 = not admin.

Available options:
0,
1
​
owner
enum<integer>

Whether the worker is an owner. 1 = owner, 0 = not owner.

Available options:
0,
1
​
permissions
object

Granular module-level permission flags. All values are 1 (enabled) or 0 (disabled).