Overview

Vacation Manager's REST API provides team API which allows you to obtain:

Methods

GET

Anchor
getVacationDefinition
getVacationDefinition

...

Expand

title	Get vacation definition with given ID

Returns vacation definition with given ID

Path

Code Block
GET {jira_baseurl}/rest/vacation-manager/1.0/vacation-definition/{vacationDefinitionId}

Permissions

Status

colour	Green
title	ADMIN

Status
colour Red
title USER

Status
colour Red
title SUPERVISOR

Status
colour Green
title HR

Path params

Name	Type	Description
vacationDefinitionId	int	Vacation definition ID

Responses

Status

colour	Green
title	200

Status

colour	Yellow
title	400

Status

colour	Red
title	500

Example

Expand

title	Example

Code Block

title	Path

GET {jira_baseurl}/rest/vacation-manager/1.0/vacation-definition/1

Code Block

title	Response

[
  {
    "id": 1,
    "vacationTypeId": 1,
    "userId": 10000,
    "vacationTypeName": "remote",
    "startDate": "2021-02-01",
    "dayLimit": 0
}
]

Anchor
getVacationInstancesByVacationDefinition
getVacationInstancesByVacationDefinition

Expand

title	Get vacation definition with given ID

Returns list of vacation instances for given vacation definition,

Path

Code Block
GET {jira_baseurl}/rest/vacation-manager/1.0/vacation-definition/{vacationDefinitionId}/vacation-instance

Permissions

Status

colour	Green
title	ADMIN

Status
colour Red
title USER

Status
colour Red
title SUPERVISOR

Status
colour Green
title HR

Path params

Name	Type	Description
vacationDefinitionId	int	Vacation definition ID

Responses

Status

colour	Green
title	200

Status

colour	Yellow
title	400

Status

colour	Red
title	500

Example

Expand

title	Example

Code Block

title	Path

GET {jira_baseurl}/rest/vacation-manager/1.0/vacation-definition/6/vacation-instance

Code Block

title	Response

[
  {
    "id": 8,
    "startDate": "2021-01-01",
    "endDate": "2021-01-31",
    "availableDays": 5,
    "availableMinutes": 0,
    "entitledDays": 5,
    "carryOverDays": 0,
    "carryOverMinutes": 0,
    "usedDays": 0,
    "usedMinutes": 0,
    "vacationDocuments": [],
    "vacationDefinitionId": 6,
    "remainingCarryOverDays": 0,
    "remainingCarryOverMinutes": 0
  },
  {
    "id": 9,
    "startDate": "2021-02-01",
    "endDate": "2021-02-28",
    "availableDays": 10,
    "availableMinutes": 0,
    "entitledDays": 5,
    "carryOverDays": 5,
    "carryOverMinutes": 0,
    "usedDays": 0,
    "usedMinutes": 0,
    "vacationDocuments": [],
    "vacationDefinitionId": 6,
    "remainingCarryOverDays": 5,
    "remainingCarryOverMinutes": 0
  },
  {
    "id": 10,
    "startDate": "2021-03-01",
    "endDate": "2021-03-31",
    "availableDays": 5,
    "availableMinutes": 0,
    "entitledDays": 5,
    "carryOverDays": 0,
    "carryOverMinutes": 0,
    "usedDays": 0,
    "usedMinutes": 0,
    "vacationDocuments": [],
    "vacationDefinitionId": 6,
    "remainingCarryOverDays": 0,
    "remainingCarryOverMinutes": 0
  }
]

...

Expand

title	Create vacation definition

Creates and returns vacation definition.

Path

Code Block
POST {jira_baseurl}/rest/vacation-manager/1.0/vacation-definition

Permissions

Status

colour	Green
title	ADMIN

Status
colour Red
title USER

Status
colour Red
title SUPERVISOR

Status
colour Green
title HR

JSON body fields

Name	Type	Description
vacationTypeId	Integer	vacation type id
userName	String	username to which dew vacation definition will be assigned
startDate	String	Date when user is enabled to request vacation using this definition. ISO 8601 format.
endDate	String	Date when one time vacation type no longer enables user to request vacation using it. Must be used only when vacation has valid through option enabled. ISO 8601 format.
dayLimit	Double	Default day limit. Should be integer when vacation is "daily only" or "daily or hourly". May contain additional half if vacation is "daily or half daily"

Responses

Status

colour	Green
title	201

Status

colour	Yellow
title	400

Status

colour	Red
title	500

Example

Expand

title	Example

Code Block

title	Path

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

Code Block

title	Body

{
  "vacationTypeId":"1",
  "userName": "userName",
  "startDate": "2018-09-10",
  "endDate": "2018-09-20",
  "dayLimit": 5
}

Code Block

title	Response

{
  "id": 8,
  "vacationTypeId": 1,
  "userName": "userName",
  "vacationKindName": "Vacation kind name",
  "startDate": "2018-09-10",
  "endDate": "2018-09-20",
  "dayLimit": 5
}

...

Versions Compared

Old Version 7

New Version 8

Key

Overview

Vacation Manager's REST API provides team API which allows you to obtain:

Methods

GET

Anchor
getVacationDefinition
getVacationDefinition

Path

Permissions

Path params

Responses

Example

Anchor
getVacationInstancesByVacationDefinition
getVacationInstancesByVacationDefinition

Path

Permissions

Path params

Responses

Example

Path

Permissions

JSON body fields

Responses

Example

Page Comparison

Versions Compared

Old Version 7

New Version 8

Key

Vacation Manager's REST API provides team API which allows you to obtain:

Methods

GET

AnchorgetVacationDefinitiongetVacationDefinition

Path

Permissions

Path params

Responses

Example

AnchorgetVacationInstancesByVacationDefinitiongetVacationInstancesByVacationDefinition

Path

Permissions

Path params

Responses

Example

Path

Permissions

JSON body fields

Responses

Example

Anchor
getVacationDefinition
getVacationDefinition

Anchor
getVacationInstancesByVacationDefinition
getVacationInstancesByVacationDefinition