Overview

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

Methods

GET

Anchor
getVacationDefinition
getVacationDefinition

Expand

title	Get vacation definition

Returns all vacation definitions for current user or only selected one vacation definition.

Path

Code Block
GET {jira_baseurl}/rest/vacation-manager/1.0/vacation-definition/user/{userName}?vacationTypeId={vacationTypeId}

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
userName	String	User name

Query params

Name	Type	Description
vacationTypeId	int	Vacation type 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/userName

Code Block

title	Response

[
  {
    "id": 1,
    "vacationTypeId": 1,
    "userId": "1",
	"userName": "userName",
    "vacationKindName": "vacation kind name 1",
    "startDate": "2018-10-18",
    "dayLimit": 0
  },
  {
    "id": 2,
    "vacationTypeId": 2,
	"userName": "userName",
    "vacationKindName": "vacation kind name 2",
    "startDate": "2018-10-30",
    "dayLimit": 23
  }
]

...

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
}

...

Expand

title	Delete vacation definition

Deletes vacation definition.

Path

Code Block
delete {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	204

Status

colour	Yellow
title	404

Status

colour	Red
title	500

Example

Expand

title	Example

Code Block

title	Path

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

========

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
}
]

Versions Compared

Old Version 1

New Version 2

Key

Overview

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

Methods

GET

Anchor
getVacationDefinition
getVacationDefinition

Path

Permissions

Path params

Query params

Responses

Example

Path

Permissions

JSON body fields

Responses

Example

Path

Permissions

Path params

Responses

Example

Path

Permissions

Path params

Responses

Example

Page Comparison

Versions Compared

Old Version 1

New Version 2

Key

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

Methods

GET

AnchorgetVacationDefinitiongetVacationDefinition

Path

Permissions

Path params

Query params

Responses

Example

Path

Permissions

JSON body fields

Responses

Example

Path

Permissions

Path params

Responses

Example

Path

Permissions

Path params

Responses

Example

Anchor
getVacationDefinition
getVacationDefinition