> ## Documentation Index
> Fetch the complete documentation index at: https://developers.lucca.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

```http theme={null}
GET api/v3/users/me/delegation
```

```json theme={null}
{
    "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.

```http theme={null}
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.

```http theme={null}
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.

```http theme={null}
PUT /api/v3/users/123/delegation HTTPS/2
Host: example.ilucca.net
Content-Type: application/json

{
    "isActive": false
}
```

Do the opposite to reactivate it.