Page Comparison

...

Responses:

Status

colour	Green
title	200

Status

colour	Yellow
title	404

Status

colour	Red
title	500

Path params

Name	Type	Description
teamId	int	Team ID

Expand

title	Example

Path

Code Block
GET {jira_baseurl}/rest/vacation-manager/1.0/team/1

Response

Code Block

{
  "id": 1,
  "name": "teamName",
  "description": "description",
  "users": [
    {
      "id": 1,
      "name": "user 1",
      "displayName": "User 1",
      "active": true
    },
    {
      "id": 2,
      "name": "user 2",
      "displayName": "User 2",
      "active": true
    },
    {
      "id": 3,
      "name": "user 3",
      "displayName": "User 3",
      "active": true
    }
  ],
  "supervisors": [
    {
      "id": 4,
      "name": "supervisor 1",
      "displayName": "Supervisor 1",
      "active": true
    }
  ]
}

...

Responses:

Status

colour	Green
title	200

Status

colour	Yellow
title	400

Status

colour	Red
title	500

Path params

Name	Type	Description
teamId	int	Team ID

Expand

title	Example

Path

Code Block
GET {jira_baseurl}/rest/vacation-manager/1.0/team/1/member

Response

Code Block

{
    "id": 1,
    "name": "teamName",
    "description": "description",
    "user": {
        "users": [
			{
                "id": 1,
                "userId": 10,
                "role": "USER",
                "teamId": 1
			},
			{
                "id": 2,
                "userId": 20,
                "role": "USER",
                "teamId": 1
			},
			{
                "id": 3,
                "userId": 30,
                "role": "USER",
                "teamId": 1
			}
		],
        "groups": [
            {
                "id": 7,
                "groupName": "users",
                "role": "USER",
                "teamId": 1
            }
        ]
    },
    "supervisor": {
        "users": [
			{
                "id": 4,
                "userId": 40,
                "role": "SUPERVISOR",
                "teamId": 1
			},
			{
                "id": 5,
                "userId": 50,
                "role": "SUPERVISOR",
                "teamId": 1
			},
			{
                "id": 6,
                "userId": 60,
                "role": "SUPERVISOR",
                "teamId": 1
			}
		],
        "groups": [
			{
                "id": 8,
                "groupName": "supervisors",
                "role": "SUPERVISOR",
                "teamId": 1
            }
		]
    }
}

...

Responses:

Status

colour	Green
title	201

Status

colour	Yellow
title	400

Status

colour	Red
title	500

JSON body fields

Name	Type	Description
name	String	Team name, must be unique for each team
description	String (Optional)	Team description

Expand

title	Example

Path

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

Body

Code Block
{ "name": "Team name", "description": "Team Description" }

Response

Code Block
{ "id": "name": "Team name", "description": "Team Description" }

...

Responses:

Status

colour	Green
title	201

Status

colour	Yellow
title	400

Status

colour	Yellow
title	404

Status

colour	Red
title	500

Path params

Name	Type	Description
teamId	int	Team id

JSON body fields

Name	Type	Description
type	MemberType	Type of member
name	String	Name of the member you want to add to the team
role	MemberRole	Role for member

MemberType

Name	Type	Description
USER	Enum	User type
GROUP	Enum	Group type

MemberRole

Name	Type	Description
USER	Enum	User role for member
SUPERVISOR	Enum	Supervisor role for member

Expand

title	Example

Path

Code Block
POST {jira_baseurl}/rest/vacation-manager/1.0/team/1/member

Add user to team

Body

Code Block
{ "type":"USER", "name":"user 1", "role":"USER" }

Response

Code Block
{ "id": 1, "userId": 10000, "role": "USER", "teamId": 1 }

Add group to team

Body

Code Block
{ "type":"GROUP", "name":"users", "role":"USER" }

Response

Code Block
{ "id": 6, "groupName": "users", "role": "USER", "teamId": 1 }

...

Responses:

Status

colour	Green
title	200

Status

colour	Yellow
title	400

Status

colour	Yellow
title	404

Status

colour	Red
title	500

Path params

Name	Type	Description
teamId	int	Team ID

JSON body fields

Name	Type	Description
name	String	Team name, must be unique
description	String (Optional)	Team description
allowUsersViewStatistics	bool (Optional)	as name says, it’s boolean value that can be either true or false,
defaultSupervisorId	int (Optional)	ID (number value - not user name!) of a user that will be set as default supervisor, -1 means that this value will be cleared and default supervisor will be removed from team.

Expand

title	Example

Path

Code Block
PATCH {jira_baseurl}/rest/vacation-manager/1.0/team/1

Body

Code Block
{ "name": "new team name" }

Request

Code Block
{ "id": 1, "name": "new team name", "description": "Team Description" }

...

Responses:

Status

colour	Green
title	204

Status

colour	Yellow
title	404

Status

colour	Red
title	500

Path params

Name	Type	Description
teamId	int	Team ID

Expand

title	Example

Request

Code Block
DELETE {jira_baseurl}/rest/vacation-manager/1.0/team/1

...

Responses:

Status

colour	Green
title	204

Status

colour	Yellow
title	404

Status

colour	Red
title	500

Path params

Name	Type	Description
teamId	int	Team ID

JSON body fields

Name

Type

Description

type

String

Type of member to remove

USER
GROUP

name

String

Name of the member you want to remove from the team

role

String

Role for member to remove

USER
SUPERVISOR

Expand

title	Example

Path

Code Block
DELETE {jira_baseurl}/rest/vacation-manager/1.0/team/1/member

Body

Code Block
{ "type":"GROUP", "name":"users", "role":"USER" }

Versions Compared

Old Version 11

New Version 12

Key

Path params

Path

Path params

Path

Response

JSON body fields

Path

Path params

JSON body fields

MemberType

MemberRole

Path

Add user to team

Body

Response

Add group to team

Body

Response

Path params

JSON body fields

Path

Body

Request

Path params

Request

Path params

JSON body fields

Path

Body