GET

Get vacation documents list

Returns list of vacation documents available to logged user

Permissions:

GET {jira_baseurl}/rest/vacation-manager/1.0/vacation-document?teamId={teamId}

Responses:

Query params

Name	Type	Description
teamId	Integer	Team ID
reporter	String	Name of reporter of vacation document
supervisor	String	Name of supervisor assigned to vacation document
startDate	String	Date that vacation have to start after. ISO 8601 format.
endDate	String	Date that vacation have to end before. ISO 8601 format.
periodStartDate	String	The start date of the vacation period for which we want a vacation list. ISO 8601 format.
periodEndDate	String	The end date of the vacation period for which we want a vacation list. ISO 8601 format. When you set the periodStartDate and periodEndDate, you will search for vacation documents started/ongoing/ended during that period.

Path

GET {jira_baseurl}/rest/vacation-manager/1.0/vacation-document?teamId=1

Response

[
    {
        "issueId": 10600,
        "issueKey": "VACMAN-1",
        "reporter": {
            "id": 1,
            "name": "user",
            "displayName": "User",
            "active": true
        },
        "supervisor": {
            "id": 2,
            "name": "supervisor",
            "displayName": "Supervisor",
            "active": true
        },
        "status": "OPEN",
        "selectedPeriod": {
            "periodType": "DAILY",
            "startDateTime": 1540159200000,
            "endDateTime": 1540331999999,
            "startDate": 1540159200000,
            "endDate": 1540331999999,
            "usedDays": 0,
            "usedMinutes": 0
        }
    },
    {
        "issueId": 10502,
        "issueKey": "VACMAN-2",
        "reporter": {
            "id": 1,
            "name": "user",
            "displayName": "User",
            "active": true
        },
        "supervisor": {
            "id": 2,
            "name": "supervisor",
            "displayName": "Supervisor",
            "active": true
        },
        "status": "OPEN",
        "selectedPeriod": {
            "periodType": "HOURLY",
            "startDateTime": 1540371600000,
            "endDateTime": 1540378800000,
            "startDate": 1540371600000,
            "endDate": 1540378800000,
            "usedDays": 0,
            "usedMinutes": 0
        }
    }
]

Get single vacation document

Returns information about existing vacation document.

Permissions:

GET {jira_baseurl}/rest/vacation-manager/1.0/vacation-document/{issueKey}

Responses:

Path params

Name	Type	Description
issueKey	String	Issue key

Request

GET {jira_baseurl}/rest/vacation-manager/1.0/vacation-document/{issueKey}

Response

{
    "issueId": 10600,
    "issueKey": "VACMAN-1",
    "reporter": {
        "id": 1,
        "name": "user",
        "displayName": "User",
        "active": true
    },
    "supervisor": {
        "id": 2,
        "name": "supervisor",
        "displayName": "Supervisor",
        "active": true
    },
    "status": "OPEN",
    "selectedPeriod": {
        "periodType": "DAILY",
        "startDateTime": 1540159200000,
        "endDateTime": 1540331999999,
        "startDate": 1540159200000,
        "endDate": 1540331999999,
        "usedDays": 0,
        "usedMinutes": 0
    }
}

Get vacation documents waiting for approval

Returns vacation documents waiting for approval

Permissions:

GET {jira_baseurl}/rest/vacation-manager/1.0/vacation-document/waiting-for-approval?reporter={reporter}&supervisor={supervisor}&startDate={startDate}&endDate={endDate}

Responses:

Query params

Name	Type	Description
reporter	String	Name of reporter of vacation document
supervisor	String	Name of supervisor assigned to vacation document
startDate	String	Date that vacation have to start after. ISO 8601 format.
endDate	String	Date that vacation have to end before. ISO 8601 format.

Path

GET {jira_baseurl}/rest/vacation-manager/1.0/vacation-document/waiting-for-approval

Response

[
    {
        "issueId": 10600,
        "issueKey": "VACMAN-1",
        "reporter": "{
            "id": 1,
            "name": "user",
            "displayName": "User",
            "active": true
        },
        "supervisor": {
            "id": 2,
            "name": "supervisor",
            "displayName": "Supervisor",
            "active": true
        },
        "status": "OPEN",
        "selectedPeriod": {
            "periodType": "DAILY",
            "startDateTime": 1540159200000,
            "endDateTime": 1540331999999,
            "startDate": 1540159200000,
            "endDate": 1540331999999,
            "usedDays": 0,
            "usedMinutes": 0
        }
    },
    {
        "issueId": 10502,
        "issueKey": "VACMAN-2",
        "reporter": {
            "id": 1,
            "name": "user",
            "displayName": "User",
            "active": true
        },
        "supervisor": {
            "id": 2,
            "name": "supervisor",
            "displayName": "Supervisor",
            "active": true
        },
        "status": "OPEN",
        "selectedPeriod": {
            "periodType": "HOURLY",
            "startDateTime": 1540371600000,
            "endDateTime": 1540378800000,
            "startDate": 1540371600000,
            "endDate": 1540378800000,
            "usedDays": 0,
            "usedMinutes": 0
        }
    }
]

Get actions for vacation document

Returns available actions that could be executed upon vacation document.

Permissions:

GET {jira_baseurl}/rest/vacation-manager/1.0/vacation-document/{issueKey}/actions

Responses:

Path params

Name	Type	Description
issueKey	String	Issue key

Path

GET {jira_baseurl}/rest/vacation-manager/1.0/vacation-document/VACMAN-2/actions

Response

[
    {
        "id": 11,
        "name": "Approve"
    },
    {
        "id": 21,
        "name": "Reject"
    },
    {
        "id": 41,
        "name": "More information required"
    }
]

POST

Create new vacation document

Create and returns new vacation document. It creates new Jira issue.

Permissions:

POST {jira_baseurl}/rest/vacation-manager/1.0/vacation-document

Responses:

JSON body fields

Name

Type

Description

reporterName

String

Reporter name

supervisorName

String

Supervisor name

substituteName

String (Optional)

Substitute name

description

String (Optional)

Description for created issue

vacationKindId

Integer

Vacation document is created for vacation kind with this id

periodType

PeriodType

Period type

startDate

String (Optional)

Start date of the leave for daily and half-daily requests. ISO 8601 format.

startDateTime

String (Optional)

Start date time of the leave for hourly requests. ISO 8601 format.

endDate

String (Optional)

End date of the leave for daily requests. ISO 8601 format.

halfDayType

HalfDayType (Optional)

Required for half-daily requests.

endTimeMinutes

Integer (Optional)

Duration of hourly leave in minutes. Required for hourly request

PeriodType

Name	Type	Description
DAILY	Enum	Daily peroid type
HALF_DAILY	Enum	Half daily period type
HOURLY	Enum	Hourly period type

HalfDayType

Name	Type	Description
AM	Enum	First half of work day
PM	Enum	Second half of work day

Path

POST {jira_baseurl}/rest/vacation-manager/1.0/vacation-document

Body

{
	"reporterName": "user",
	"supervisorName": "supervisor",
	"substituteName": "james",
	"vacationKindId": 1,
	"periodType": "DAILY",
	"startDate": "2018-10-10",
	"endDate": "2018-10-12"
}

Response

{
    "issueId": 10600,
    "issueKey": "VACMAN-1",
    "reporter": {
        "id": 1,
        "name": "user",
        "displayName": "User",
        "active": true
    },
    "supervisor": {
        "id": 2,
        "name": "supervisor",
        "displayName": "Supervisor",
        "active": true
    },
    "status": "OPEN",
    "selectedPeriod": {
        "periodType": "DAILY",
        "startDateTime": 1540159200000,
        "endDateTime": 1540245599999,
        "startDate": 1540159200000,
        "endDate": 1540245599999,
        "usedDays": 0,
        "usedMinutes": 0
    }
}

PUT

Update vacation document

Updates existing vacation document.

Permissions:

PUT {jira_baseurl}/rest/vacation-manager/1.0/vacation-document

Responses:

JSON body fields

Name

Type

Description

reporterName

String

Reporter name

supervisorName

String

Supervisor name

substituteName

String (Optional)

Substitute name

description

String (Optional)

Description for created issue

vacationKindId

Integer

Vacation document is created for vacation kind with this id

periodType

PeriodType

Period type

startDate

String (Optional)

Start date of the leave for daily and half-daily requests. ISO 8601 format.

startDateTime

String (Optional)

Start date time of the leave for hourly requests. ISO 8601 format.

endDate

String (Optional)

End date of the leave for daily requests. ISO 8601 format.

halfDayType

HalfDayType (Optional)

Required for half-daily requests.

endTimeMinutes

Integer (Optional)

Duration of hourly leave in minutes. Required for hourly request

PeriodType

Name	Type	Description
DAILY	Enum	Daily peroid type
HALF_DAILY	Enum	Half daily period type
HOURLY	Enum	Hourly period type

HalfDayType

Name	Type	Description
AM	Enum	First half of work day
PM	Enum	Second half of work day

Path

PUT {jira_baseurl}/rest/vacation-manager/1.0/vacation-document

Body

{
	"issueKey": "VACMAN-1",
	"reporterName": "user",
	"supervisorName": "supervisor",
	"periodType": "DAILY",
	"startDate": "2018-10-22",
	"endDate": "2018-10-23"
}

Update status of vacation document

Updates status of vacation document.

Permissions:

PUT {jira_baseurl}/rest/vacation-manager/1.0/vacation-document/status

Responses:

JSON body fields

Name	Type	Description
issueKey	String	Key of issue to update status
actionId	Integer	Id of action to execute on issue in order to make transition. To retrieve available actions, see get actions
comment	String (optional)	Comment to add upon changing status. Some actions require comments

Path

PUT {jira_baseurl}/rest/vacation-manager/1.0/vacation-document/status

Body

{
	"issueKey": "VACMAN-1",
	"actionId": 1,
	"comment": "Example comment"
}