Delegation

​

Introduction

Delegation consists of choosing a someone to delegate to and the delegation period :

• only during manager’s holidays, this is the default strategy
• permanently, if I never have time to validate the requests of my collaborators
• from date to date, for a one-off delegation not related to my holidays

Here are the properties of the delegation resource:

• Owner: the one who delegates
• Delegatee: the user targeted by the delegation, the one to whom we delegate
• StartsOn: for a date-to-date delegation, the start date (included)
• EndsOn: for a date-to-date delegation, the end date (inclusive)
• OnlyDuringHolidays: Boolean that allows you to indicate that you only want to delegate during your holidays & absences
• IsActive: indicates the state of the delegation, allows if necessary to temporarily deactivate the delegation without losing its information (delegate, strategy)

NB: The delegation does not have a unique ID, so it is a resource available under the ‘users’ resource.

​

Retrieve the delegation of the current user

You can retrieve delegation information via the following API.

GET api/v3/users/me/delegation

{
    "delegateeId": 33,
    "delegatee": {
        "id": 33,
        "name": "John Doe"
    },
    "startsOn": null,
    "endsOn": null,
    "isActive": true,
    "onlyDuringHolidays": true
}

​

Modify the user’s delegate

Here we assign user (id=34) as the delegate of user (id=123) with the same previous period of delegation.

PUT /api/v3/users/123/delegation HTTPS/2
Host: example.ilucca.net
Content-Type: application/json

{
    "delegatee": {
        "id": 34
    }
}

​

Modify delegation period

In order to swith the period from “during holidays” to a date to date period, you need to deactivate the first strategy and indicate the period.

PUT /api/v3/users/123/delegation HTTPS/2
Host: example.ilucca.net
Content-Type: application/json

{
    "onlyDuringHolidays": false,
    "startsOn": "2016-01-01",
    "endsOn": "2016-12-31"
}

For a permanent delegation, set startsOn and endsOn to NULL. You can also set only the startsDate so that the permanent delegation strarts from a specific date.

​

Deactivate delegation

To cancel or deactivate temporarily the delegation, change the activation status.

PUT /api/v3/users/123/delegation HTTPS/2
Host: example.ilucca.net
Content-Type: application/json

{
    "isActive": false
}

Do the opposite to reactivate it.