Users

Patch Company-specific details

Update user information that is specific to the current company.

Only fields that are provided and are not null will be updated.

patch/v1/user/{user_id}/company/

Request

  • Base URL
    https://developer.beta.salussafety.io
  • URL
    https://developer.beta.salussafety.io/v1/user/{user_id}/company/
  • Auth
    • HTTP bearer
    • or OAuth 2
      Client credentials
      Token URL: https://guardian.beta.salussafety.io/token
    • or OAuth 2
      Authorization code: https://guardian.beta.salussafety.io/authorize
      Token URL: https://guardian.beta.salussafety.io/token

Path parameters

user_idinteger required

Request body

isActiveboolean nullable

Indicates that this user is active in the company.

editTimerboolean nullable

Indicates if a user can edit timers that they have created.

createTimerboolean nullable

Indicates if a user can create a time and log time.

documentAccess'none' | 'read' | 'write'

Company user access type enumeration.

feedAccess'none' | 'read' | 'write'

Company user access type enumeration.

positionstring nullable

Optionally, specify the users position in the company.

employeeIdstring nullable

Optionally, specify an external employee ID so that it can be correlated with an external system.

Example request

{
  "isActive": true,
  "editTimer": true,
  "createTimer": true,
  "position": "Office Manager",
  "employeeId": "EM00123"
}

Response

Successful Response

errorboolean

A boolean error indicator.

messagestring nullable

Optional message.

Example response

{
  "data": {
    "id": 1275,
    "role": {
      "id": 4,
      "name": "Foreman",
      "slug": "foreman"
    },
    "isActive": true,
    "employeeId": "EM00123",
    "position": "Office Manager",
    "editTimer": true,
    "createTimer": true,
    "userId": 2,
    "companyId": 1
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.