Relesys API Docs

Users

Update User

PATCH /users/{userId}

https://api.uat.relesystest.net/api/v1.4/users/{userId}

Update a user based on the ID provided. Accepts a JsonPatch request in the body.

When patching the customFields array, the externalId (see the documentation for 'Get User Custom Fields') is used as the key reference.

Scopes: relesys.api, relesys.api:write, relesys.api.users, relesys.api.users:write

URL Path

userId

string / guid

The user's unique identifier

required

Request Body

application/json-patch+json

Schema Example

JSON

[{"value":"My patched name","path":"/name","op":"add"},{"value":{"countryCode":45,"number":"11223344"},"path":"/phoneNumber","op":"replace"},{"path":"/title","op":"remove"},{"value":{"customfieldone":"Custom field 1","customfieldtwo":"Custom field 2","birthday":"2002-12-30","skills":["Marketing","Design"]},"path":"/customFields","op":"add"},{"value":"Female","path":"/gender","op":"replace"},{"value":"NUA","path":"/initials","op":"add"},{"value":"R-12345","path":"/registerNumber","op":"add"},{"value":"D-67890","path":"/dutyPlanNumber","op":"add"},{"value":"bac09b1a-61b3-4915-9180-9813d4edce83","path":"/imageId","op":"replace"},{"value":"5d3604b2-3186-4d4c-888b-00778399f44f","path":"/memberCardId","op":"replace"},{"value":"1234567890","path":"/cardNumber","op":"replace"}]

array[object]
from	string	optional
op	string	optional
path	string	optional
value	object	optional

Responses

application/json

Schema Example

JSON

{"data":{"id":"c46a08ad-b6c1-48e5-967e-2c7497626aa3","url":null,"departmentUrl":null,"status":"Activated","creationDateTime":"2026-06-23T17:39:04.8604436Z","lastModifiedDateTime":"2026-06-23T17:39:04.8604436Z","image":{"id":"8ed2278c-15a5-44f0-95cd-6082a43c9e79","downloadUrl":null,"referenceUrl":null,"contentType":"image/png","fileName":"image.png"},"memberCard":{"name":"Member Card Name","cardNumber":"1234567890","id":"2a5fa5b6-cde2-4256-9219-8d5b43fef2d8","url":null},"externalId":"NUA","name":"New User A","initials":"NUA","userName":"UserNameA","title":"User Title A","dataSource":"RelesysAPI","email":"personalmaila@testmail.com","secondaryEmail":"businessmaila@testmail.com","phoneNumber":{"countryCode":45,"number":"12345678"},"secondaryPhoneNumber":{"countryCode":45,"number":"12345679"},"birthDate":"2002-12-30T00:00:00Z","gender":"Male","primaryDepartmentId":"f0a3e51f-6ae4-4c8c-9681-8cd039e54d28","additionalDepartments":[{"id":"21c4cc20-2b45-46cc-839d-afefe2883ba5","dataSource":"RelesysAPI"}],"userGroups":[{"id":"db40328c-c70d-4a99-850a-3d236e535c81","dataSource":"RelesysAPI"},{"id":"aa402c7f-b343-4848-aaf8-0902d686d2cb","dataSource":"RelesysAPI"}],"employmentDate":"2018-12-30T13:30:00Z","employmentEndDate":"2021-12-30T13:30:00Z","customFields":{"customfieldone":"Custom field 1","birthday":"2002-12-30","skills":["Marketing"]},"employmentType":"Full-time manager","registerNumber":"RN12345","dutyPlanNumber":"DP12345"}}

object
⯈ data	object
⯈ additionalDepartments	array[object]
dataSource	string
id	string / guid
birthDate	datetime
customFields	dictionary`2
dataSource	string
departmentUrl	string
dutyPlanNumber	string
email	string
employmentDate	datetime
employmentEndDate	datetime
employmentType	string
externalId	string
gender	string
id	string / guid
⯈ image	object
contentType	string
downloadUrl	string
fileName	string
id	string / guid
referenceUrl	string
initials	string
⯈ memberCard	object
cardNumber	string
id	string / guid
name	string
url	string
name	string
⯈ phoneNumber	object
countryCode	integer
number	string
primaryDepartmentId	string / guid
registerNumber	string
secondaryEmail	string
⯈ secondaryPhoneNumber	object
countryCode	integer
number	string
status	string
title	string
url	string
⯈ userGroups	array[object]
dataSource	string
id	string / guid
userName	string

Relesys API Docs

v1.4

Welcome

Concepts

Endpoints

Users

URL Path

Request Body

Responses