Request: POST /users/work-leave-status
Permissions to Run the Request
Account Owner, Account Administrators, Department Administrators, or custom roles.
Department Administrators and users with a custom role can add users only to the departments they manage and their sub-departments.
Request Headers and Parameters
| Header | Description |
|---|---|
| Authorization (required) | Access token. You can obtain a token by making a request |
| Parameter | Description |
| userid (required) | The ID of a user you want to add a work leave status for |
| workLeaveReason (required) | Reasons for work leave status:
|
| startDate (optional) | The work leave status start date. You can add it in the yyyy-mm-dd format |
| endDate (optional) | The work leave status end date. You can add it in the yyyy-mm-dd format |
Possible Response Codes
| Code | Text | Description |
|---|---|---|
| 200 | OK | A new work leave status has been added |
| 400 | Bad Request | Some of the sent parameters are incorrect |
| 401 | Unauthorized | An authorization error |
| 403 | Permission Denied | The user doesn't have enough permissions to add other users. For instance, Department Administrators can't add work leave statuses to users from a department they don't manage |
Sample Request
POST /users/work-leave-status https/1.1
Host: api-learn.ispringlearn.com
Authorization: p-1sJDjmULL5DdpXPJTcbm4jVIaWVHvNmrjAxATRbNE
Content-Type:application/xml
<?xml version="1.0" encoding="UTF-8"?>
<request>
<workLeaveStatuses>
<userId>76a38028-c8b7-11ed-a616-0542ac15004f</userId>
<workLeaveReason>SickLeave</workLeaveReason>
<startDate>2024-01-12</startDate>
<endDate>2024-01-15</endDate>
</workLeaveStatuses>
<workLeaveStatuses>
<userId>f5bafbba-c7eb-11ed-a327-0242ac12004e</userId>
<workLeaveReason>PersonalLeave</workLeaveReason>
<startDate>2024-01-12</startDate>
<endDate>2024-01-20</endDate>
</workLeaveStatuses>
</request>
Sample Response
https/1.1 200 OK <?xml version="1.0" encoding="UTF-8"?>