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
cidThe company id.int
activeIndicates if the person is active. Please note that the method always returns active people only.bool
fnameFirst namestring
lnameLast namestring
titleOptional title of person. Nullable.string?
codeOptional code of person. Platform defined purpose. If not assigned then empty string.string
emailEmail address.string
roleOptional role of person within the company. Nullablestring?
phoneOptional phone. Nullablestring?
phoneMobileOptional mobile phone. Nullablestring?


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": []
}

 

 

 

Copyright Wordbee - Buzzin' Outside the Box since 2008