jobs/{id}/action/reassign-person

It is for use with action "REASSIGN_PERSON" to reassign a job to a colleague. The action must appear in jobs/{id}/summary

The method returns qualified users of the user's company. Once a cid/uid tuple selected, the assignment is done with method jobs/{id}/action/commit

Access rights constraints:

The current user must have the "REASSIGN_PERSON" action enabled.
The current user must have the access rights to enumerate colleagues and to view user names.

URL

(GET) /jobs/{id}/action/reassign-person

PARAMETERS

URL parameters are:

id

The job ID. Also see jobs/{id}/summary

string, Mandatory

RESULTS

The resulting JSON object has these properties:

count	Total persons returned.	int
items	List of persons of the current user's company to which the job can be assigned, see below for properties.	object[]

Each item has these properties:

uid	The person id.	int
cid	The company id.	int
active	Indicates if the person is active. Please note that the method always returns active people only.	bool
fname	First name	string
lname	Last name	string
title	Optional title of person. Nullable.	string?
code	Optional code of person. Platform defined purpose. If not assigned then empty string.	string
email	Email address.	string
role	Optional role of person within the company. Nullable	string?
phone	Optional phone. Nullable	string?
phoneMobile	Optional mobile phone. Nullable	string?

EXAMPLES

A single user is available:

CODE

{
  "count": 1,
  "items": [
    {
      "uid": 17,
      "cid": 10,
      "active": true,
      "fname": "Philip",
      "lname": "Bruce",
      "title": null,
      "code": "PB",
      "role": null,
      "phone": null,
      "phoneMobile": null,
      "email": "jclement@alpha.com"
    }
  ]
}

The user cannot reassign the job or no people available:

CODE

{
  "count": 0,
  "items": []
}