POST Agents/Person/Merge

• 2 minutes to read

POST /api/v1/Agents/Person/Merge

Merge two persons.

The destination person will remain. You must specify the date after which activities will be moved along with the person.

Query String Parameters

Parameter Name	Type	Description
$select	string	Optional comma separated list of properties to include in the result. Other fields are then nulled out to reduce payload size: "Name,department,category". Default = show all fields.

POST /api/v1/Agents/Person/Merge?$select=name,department,category/id

Request Headers

Parameter Name	Description
Authorization	Supports 'Basic', 'SoTicket' and 'Bearer' schemes, depending on installation type.
X-XSRF-TOKEN	If not using Authorization header, you must provide XSRF value from cookie or hidden input field
Content-Type	Content-type of the request body: `application/json`, `text/json`, `application/xml`, `text/xml`, `application/x-www-form-urlencoded`, `application/json-patch+json`, `application/merge-patch+json`
Accept	Content-type(s) you would like the response in:
SO-AppToken	The application token that identifies the partner app. Used when calling Online WebAPI from a server.

Request Body: request

SourcePersonId, DestinationPersonId, MoveAfterDate, DeleteSource, ReplaceEmptyFieldsOnDestination

Property Name	Type	Description
SourcePersonId	Integer
DestinationPersonId	Integer
MoveAfterDate	String
DeleteSource	Boolean
ReplaceEmptyFieldsOnDestination	Boolean

Response:

No Content

Response	Description
204	No Content

Response body: TimeZoneData

Sample request

POST /api/v1/Agents/Person/Merge
Authorization: Basic dGplMDpUamUw
Accept: application/json; charset=utf-8
Accept-Language: sv
Content-Type: application/json; charset=utf-8

{
  "SourcePersonId": 635,
  "DestinationPersonId": 401,
  "MoveAfterDate": "2011-04-16T13:14:00.8294529+02:00",
  "DeleteSource": true,
  "ReplaceEmptyFieldsOnDestination": false
}

Sample response

HTTP/1.1 204 No Content
Content-Type: application/json; charset=utf-8

null