Users and roles (partner)

Add people at your partner who can use the dashboard and the API, and control what each one can see.

Add people at your partner who can use the dashboard and the API, and control what each one can see.

Prerequisites

  • A bearer token in the Authorization header. Any endpoint that needs no token says so on its own page.
  • The id of each record the call targets. Every endpoint page lists the ids it needs.

Errors

StatusMeaning
401The bearer token is missing, expired or invalid
403The token is valid but the record sits outside your account
422The request failed validation — the response names the fields
500Unexpected server error

Individual endpoints may return more; each page lists its own.

Endpoints

MethodEndpointDescription
GETList usersList every non-deleted user in the authenticated caller's company with their role, assigned locations and assigned accounts.
POSTAdd a partner userCreate a new user under the authenticated partner company, sets their role (admin / assign_brand / basic), optionally assigns account access and default reports, and emails first-login credentials via the white-label-aware welcome email.
POSTGet one userReturns the full detail of a single partner user (identified by user_id) including derived user_type, role, assigned locations and assigned accounts.
POSTEdit a partner userUpdate an existing partner user's name/title, role, account assignments, optional password and deactivation date.