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:

 

{
  "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:

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