[REST 1.1] Vacation definitions

Owned by Marcin Wikarski (Unlicensed)
Last updated: 09/Jul/21 by Łukasz Modzelewski (Unlicensed)
3 min read

GET

Get vacation definition

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

Permissions: ADMIN USER SUPERVISOR HR

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

Responses: 200 400 500

Path params

Name

Type

Description

Name

Type

Description

userName

String

User name

Query params

Name

Type

Description

Name

Type

Description

vacationTypeId

int

Vacation type Id

Path
GET {jira_baseurl}/rest/vacation-manager/1.0/vacation-definition/user/userName
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 } ]

Get vacation definition with given ID

Returns vacation definition with given ID

Permissions: ADMIN USER SUPERVISOR HR

Responses: 200 400 500

Path params

Name

Type

Description

Name

Type

Description

vacationDefinitionId

int

Vacation definition ID

Path
Response

Get vacation instances for vacation definition

Returns list of vacation instances for given vacation definition,

Permissions: ADMIN USER SUPERVISOR HR

Responses: 200 400 500

Path params

Name

Type

Description

Name

Type

Description

vacationDefinitionId

int

Vacation definition ID

Path
Response

POST

Create vacation definition

Creates and returns vacation definition.

Permissions: ADMIN USER SUPERVISOR HR

Responses: 201 400 500

JSON body fields

Name

Type

Description

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"

Path
Body
Response

PUT

Update vacation definition

Returns and updates vacation definition.

Permissions: ADMIN USER SUPERVISOR HR

Responses: 200 400 500

Path params

Name

Type

Description

Name

Type

Description

vacationDefinitionId

int

Vacation definition ID

JSON body fields

Name

Type

Description

Name

Type

Description

dayLimit

double

Day limit

Path
Body
Response

DELETE

Delete vacation definition

Deletes vacation definition.

Permissions: ADMIN USER SUPERVISOR HR

Responses: 204 404 500

Path params

Name

Type

Description

Name

Type

Description

vacationDefinitionId

int

Vacation definition ID

Feel free to tell us what topic should be covered: vacationmanager@psc-software.atlassian.net