Update user role

PUT/api/v1/businesses/users/{user_id}

Change a user's access level and/or sidebar section visibility in this business.

Operation ID: update_user_role_in_business_api_v1_businesses_users__user_id__put·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Parameters

Path

user_idstringrequired

Request body

Schema: BusinessUserRoleUpdateRequest

roleRolerequiredRole: Role: owner, admin, member, or viewer
visible_sectionsarray · string: Sidebar section keys visible to this user for this business. null = all sections visible (default). Empty list = none visible. Opaque strings owned by the frontend; UI-level visibility only (not a data authorization control). Omit this field entirely to leave visibility unchanged.

Responses

200Successful Response

Schema: SuccessEnvelope_UpdateUserRoleInBusinessResponse_

successboolean
messagestring
codestring
dataUpdateUserRoleInBusinessResponse

400Bad Request - Invalid input

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

404Not Found - Resource does not exist

422Validation Error

Schema: HTTPValidationError

detailarray · ValidationErrorValidationError

5 fields

locarray · string | integerrequired
msgstringrequired
typestringrequired
inputobject
ctxobject

Code samples

PUT/api/v1/businesses/users/{user_id}

bash

curl -X PUT 'https://api.ondayzero.com/api/v1/businesses/users/{user_id}' \
  -H 'Authorization: Bearer dz_your_token' \
  -H 'x-business-id: YOUR_BUSINESS_ID' \
  -H 'Content-Type: application/json' \
  -d '{
  "role": "string"
}'