Overview
Vacation Manager's REST API provides holiday API which allows you to:
Methods:
GET
...
GET
Get holidays list from scheme
Returns list of holidays assigned to given holiday scheme
...
Path
...
.
...
Permissions:
Path params
| Name | Type | Description |
|---|
| schemeId | int | scheme ID |
Response| Code Block |
|---|
GET {jira_baseurl}/rest/vacation-manager/1.0/holiday-scheme/{schemeId}/holiday |
Response:
...
Path params
Name | Type | Description |
|---|
schemeId | int | scheme ID |
| Expand |
|---|
|
| Code Block |
|---|
| GET {jira_baseurl}/rest/vacation-manager/1.0/holiday-scheme/1/holiday |
| Code Block |
|---|
| [
{
"id": 1,
"date": "1970-12-25",
"yearly": true,
"description": "Christmas",
"holidaySchemeId": 1
},
{
"id": 2,
"date": "1970-01-01",
"yearly": true,
"description": "New year",
"holidaySchemeId": 1
}
] |
|
...
POST
...
Add holiday
Returns and creates new holiday in holiday scheme.
...
Permissions:
| Code Block |
|---|
POST {jira_baseurl}/rest/vacation-manager/1.0/holiday-scheme/{schemeId}/holidayPermissions |
Responses:
...
...
...
...
...
...
...
Path params
Name | Type | Description |
|---|
schemeId | int | scheme ID |
JSON body fields
Name | Type | Description |
|---|
date | String | Holiday date. ISO 8601 format. |
yearly | Boolean | true - holiday is repeated yearly, false - holiday occurs one time, on selected date |
description | String | Holiday description |
...
Responses
...
| 200 | | Status |
|---|
| colour | Yellow |
|---|
| title | 404 |
|---|
Example
| Expand |
|---|
|
| Code Block |
|---|
| POST {jira_baseurl}/rest/vacation-manager/1.0/holiday-scheme/1/holiday |
| Code Block |
|---|
| {
"date": "2018-12-25",
"yearly": true,
"description": "Christmas"
} |
| Code Block |
|---|
| {
"id": 1,
"date": "2018-12-25",
"yearly": true,
"description": "Christmas",
"holidaySchemeId": 1
} |
|
...
PATCH
...
Update holiday
Returns and Update existing holiday.
...
Permissions:
| Code Block |
|---|
PATCH {jira_baseurl}/rest/vacation-manager/1.0/holiday-scheme/{schemeId}/holiday/{holidayId}Permissions |
Responses:
...
...
...
...
...
...
...
Path params
Name | Type | Description |
|---|
schemeId | int | scheme ID |
holidayId | int | holiday ID |
JSON body fields
Name | Type | Description |
|---|
date | String | Holiday date. ISO 8601 format. |
yearly | Boolean | true - holiday is repeated yearly, false - holiday occurs one time, on selected date |
description | String | Holiday description |
...
Responses
...
| title | 400 |
|---|
| Status |
|---|
| colour | Yellow |
|---|
| title | 404 |
|---|
Example
| Expand |
|---|
|
| Code Block |
|---|
| PATCH {jira_baseurl}/rest/vacation-manager/1.0/holiday-scheme/1/holiday/1 |
| Code Block |
|---|
| {
"date": "2019-01-01",
"yearly": true,
"description": "New year"
} |
| Code Block |
|---|
| {
"id": 1,
"date": "2019-01-01",
"yearly": true,
"description": "New year",
"holidaySchemeId": 1
} |
|
...
DELETE
...
...
Delete holiday from scheme
Deletes existing holiday.
...
Permissions:
| Code Block |
|---|
DELETE {jira_baseurl}/rest/vacation-manager/1.0/holiday-scheme/{schemeId}/holiday/{holidayId}Permissions |
Responses:
...
...
...
...
Path params
Name | Type | Description |
|---|
schemeId | int | scheme ID |
holidayId | int | holiday ID |
...
Responses
...
...
...
| Expand |
|---|
|
| Code Block |
|---|
| DELETE {jira_baseurl}/rest/vacation-manager/1.0/holiday-scheme/1/holiday/1 |
|