Portfolio for Jira API Reference

Welcome to the Team Management Public API REST documentation. In order to access the endpoints you have to authenticate your REST calls with a user with Team Management privileges.

Note: All URL paths should start with /jira/rest/teams-api/1.0
For example, the skill count URL is: /jira/rest/teams-api/1.0/skill/count

Schemes: http
Version: v1

skill

Returns entities. Specify pagination with page (default = 1) and size (default = 1) parameters or the requested ids with ids parameter!

GET /skill
page

(no description)

type
integer (int32)
in
query
size

(no description)

type
integer (int32)
in
query
ids

(no description)

format
multiple parameters (ids=aaa&ids=bbb)
type
integer[]
in
query
default

successful operation

Response Content-Types: application/json

Entity creation operation. Returns the new entity Id.

POST /skill
undefined
Request Content-Types: application/json
Request Example
{
  "id": "integer (int64)",
  "title": "string",
  "shareable": "boolean"
}
default

successful operation

Response Content-Types: application/json

Return the total entities count

GET /skill/count
default

successful operation

Response Content-Types: application/json

Check the existence of the given ids

POST /skill/exists
integer (int64)
Request Content-Types: application/json
Request Example
[
  "integer (int64)"
]
default

successful operation

Response Content-Types: application/json

Get entity by id

GET /skill/{id}
id

(no description)

type
integer (int64)
in
path
200 OK

Entity found

Response Content-Types: application/json

Entity Update

POST /skill/{id}
undefined
id

(no description)

type
integer (int64)
in
path
Request Content-Types: application/json
Request Example
{
  "id": "integer (int64)",
  "title": "string",
  "shareable": "boolean"
}
default

successful operation

Response Content-Types: application/json

Entity Deletion

DELETE /skill/{id}
id

(no description)

type
integer (int64)
in
path
default

successful operation

Response Content-Types: application/json

resource

Returns entities. Specify pagination with page (default = 1) and size (default = 1) parameters or the requested ids with ids parameter!

GET /resource
page

(no description)

type
integer (int32)
in
query
size

(no description)

type
integer (int32)
in
query
ids

(no description)

format
multiple parameters (ids=aaa&ids=bbb)
type
integer[]
in
query
default

successful operation

Response Content-Types: application/json

Entity creation operation. Returns the new entity Id.

POST /resource
undefined
Request Content-Types: application/json
Request Example
{
  "id": "integer (int64)",
  "weeklyHours": "number (double)",
  "joinDate": "integer (int64)",
  "leaveDate": "integer (int64)",
  "teamId": "integer (int64)",
  "person": {
    "id": "integer (int64)",
    "title": "string",
    "avatarUrl": "string",
    "startDate": "integer (int64)",
    "endDate": "integer (int64)",
    "jiraUser": {
      "jiraUserId": "string",
      "title": "string",
      "email": "string",
      "avatarUrl": "string",
      "jiraUsername": "string"
    },
    "abilities": [
      {
        "id": "integer (int64)",
        "skillId": "integer (int64)",
        "personId": "integer (int64)"
      }
    ],
    "absences": [
      {
        "id": "integer (int64)",
        "start": "integer (int64)",
        "end": "integer (int64)",
        "title": "string"
      }
    ]
  },
  "availability": [
    {
      "weeklyHours": "number (double)",
      "title": "string",
      "start": "integer (int64)",
      "end": "integer (int64)"
    }
  ]
}
default

successful operation

Response Content-Types: application/json

Return the total entities count

GET /resource/count
default

successful operation

Response Content-Types: application/json

Check the existence of the given ids

POST /resource/exists
integer (int64)
Request Content-Types: application/json
Request Example
[
  "integer (int64)"
]
default

successful operation

Response Content-Types: application/json

Get entity by id

GET /resource/{id}
id

(no description)

type
integer (int64)
in
path
200 OK

Entity found

Response Content-Types: application/json

Entity Update

POST /resource/{id}
undefined
id

(no description)

type
integer (int64)
in
path
Request Content-Types: application/json
Request Example
{
  "id": "integer (int64)",
  "weeklyHours": "number (double)",
  "joinDate": "integer (int64)",
  "leaveDate": "integer (int64)",
  "teamId": "integer (int64)",
  "person": {
    "id": "integer (int64)",
    "title": "string",
    "avatarUrl": "string",
    "startDate": "integer (int64)",
    "endDate": "integer (int64)",
    "jiraUser": {
      "jiraUserId": "string",
      "title": "string",
      "email": "string",
      "avatarUrl": "string",
      "jiraUsername": "string"
    },
    "abilities": [
      {
        "id": "integer (int64)",
        "skillId": "integer (int64)",
        "personId": "integer (int64)"
      }
    ],
    "absences": [
      {
        "id": "integer (int64)",
        "start": "integer (int64)",
        "end": "integer (int64)",
        "title": "string"
      }
    ]
  },
  "availability": [
    {
      "weeklyHours": "number (double)",
      "title": "string",
      "start": "integer (int64)",
      "end": "integer (int64)"
    }
  ]
}
default

successful operation

Response Content-Types: application/json

Entity Deletion

DELETE /resource/{id}
id

(no description)

type
integer (int64)
in
path
default

successful operation

Response Content-Types: application/json

Creates a Resource Availability registry

POST /resource/{resourceId}/availability
resourceId

(no description)

type
integer (int64)
in
path
Request Content-Types: application/json
Request Example
{
  "weeklyHours": "number (double)",
  "title": "string",
  "start": "integer (int64)",
  "end": "integer (int64)"
}
default

successful operation

Response Content-Types: application/json

Deletes the Resource Availability registry

DELETE /resource/{resourceId}/availability/{availabilityId}
resourceId

(no description)

type
integer (int64)
in
path
availabilityId

(no description)

type
integer (int64)
in
path
default

successful operation

Response Content-Types: application/json

person

Returns entities. Specify pagination with page (default = 1) and size (default = 1) parameters or the requested ids with ids parameter!

GET /person
page

(no description)

type
integer (int32)
in
query
size

(no description)

type
integer (int32)
in
query
ids

(no description)

format
multiple parameters (ids=aaa&ids=bbb)
type
integer[]
in
query
default

successful operation

Response Content-Types: application/json

Entity creation operation. Returns the new entity Id.

POST /person
undefined
Request Content-Types: application/json
Request Example
{
  "id": "integer (int64)",
  "title": "string",
  "avatarUrl": "string",
  "startDate": "integer (int64)",
  "endDate": "integer (int64)",
  "jiraUser": {
    "jiraUserId": "string",
    "title": "string",
    "email": "string",
    "avatarUrl": "string",
    "jiraUsername": "string"
  },
  "abilities": [
    {
      "id": "integer (int64)",
      "skillId": "integer (int64)",
      "personId": "integer (int64)"
    }
  ],
  "absences": [
    {
      "id": "integer (int64)",
      "start": "integer (int64)",
      "end": "integer (int64)",
      "title": "string"
    }
  ]
}
default

successful operation

Response Content-Types: application/json

Deletes a Person Absence registry

DELETE /person/absence/{absenceId}
absenceId

(no description)

type
integer (int64)
in
path
default

successful operation

Response Content-Types: application/json

Return the total entities count

GET /person/count
default

successful operation

Response Content-Types: application/json

Check the existence of the given ids

POST /person/exists
integer (int64)
Request Content-Types: application/json
Request Example
[
  "integer (int64)"
]
default

successful operation

Response Content-Types: application/json

Returns Person entities suppressing abilities and absences attributes. Specify pagination with page (default = 1) and size (default = 1) parameters or the requested ids with ids parameter!

GET /person/simple
page

(no description)

type
integer (int32)
in
query
size

(no description)

type
integer (int32)
in
query
ids

(no description)

format
multiple parameters (ids=aaa&ids=bbb)
type
integer[]
in
query
default

successful operation

Response Content-Types: application/json

Get entity by id

GET /person/{id}
id

(no description)

type
integer (int64)
in
path
200 OK

Entity found

Response Content-Types: application/json

Entity Update

POST /person/{id}
undefined
id

(no description)

type
integer (int64)
in
path
Request Content-Types: application/json
Request Example
{
  "id": "integer (int64)",
  "title": "string",
  "avatarUrl": "string",
  "startDate": "integer (int64)",
  "endDate": "integer (int64)",
  "jiraUser": {
    "jiraUserId": "string",
    "title": "string",
    "email": "string",
    "avatarUrl": "string",
    "jiraUsername": "string"
  },
  "abilities": [
    {
      "id": "integer (int64)",
      "skillId": "integer (int64)",
      "personId": "integer (int64)"
    }
  ],
  "absences": [
    {
      "id": "integer (int64)",
      "start": "integer (int64)",
      "end": "integer (int64)",
      "title": "string"
    }
  ]
}
default

successful operation

Response Content-Types: application/json

Entity Deletion

DELETE /person/{id}
id

(no description)

type
integer (int64)
in
path
default

successful operation

Response Content-Types: application/json

Return the abilities of a Person

GET /person/{personId}/abilities
personId

(no description)

type
integer (int64)
in
path
default

successful operation

Response Content-Types: application/json

Creates a Person Absence registry

POST /person/{personId}/absence
undefined
personId

(no description)

type
integer (int64)
in
path
Request Content-Types: application/json
Request Example
{
  "id": "integer (int64)",
  "start": "integer (int64)",
  "end": "integer (int64)",
  "title": "string"
}
default

successful operation

Response Content-Types: application/json

Return the absences of a Person

GET /person/{personId}/absences
personId

(no description)

type
integer (int64)
in
path
default

successful operation

Response Content-Types: application/json

Creates an Ability registry, associating a Skill to a Person. Returns an Ability creation response element, with the new Ability id.

PUT /person/{personId}/skill/{skillId}
personId

(no description)

type
integer (int64)
in
path
skillId

(no description)

type
integer (int64)
in
path
default

successful operation

Response Content-Types: application/json

Disassociates the Skill from the given Person, deleting the corresponding Ability registry.

DELETE /person/{personId}/skill/{skillId}
personId

(no description)

type
integer (int64)
in
path
skillId

(no description)

type
integer (int64)
in
path
default

successful operation

Response Content-Types: application/json

teams

Returns entities. Specify pagination with page (default = 1) and size (default = 1) parameters or the requested ids with ids parameter!

GET /team
page

(no description)

type
integer (int32)
in
query
size

(no description)

type
integer (int32)
in
query
ids

(no description)

format
multiple parameters (ids=aaa&ids=bbb)
type
integer[]
in
query
default

successful operation

Response Content-Types: application/json

Entity creation operation. Returns the new entity Id.

POST /team
undefined
Request Content-Types: application/json
Request Example
{
  "id": "integer (int64)",
  "title": "string",
  "shareable": "boolean",
  "avatarUrl": "string",
  "resources": [
    {
      "id": "integer (int64)",
      "weeklyHours": "number (double)",
      "joinDate": "integer (int64)",
      "leaveDate": "integer (int64)",
      "teamId": "integer (int64)",
      "person": {
        "id": "integer (int64)",
        "title": "string",
        "avatarUrl": "string",
        "startDate": "integer (int64)",
        "endDate": "integer (int64)",
        "jiraUser": {
          "jiraUserId": "string",
          "title": "string",
          "email": "string",
          "avatarUrl": "string",
          "jiraUsername": "string"
        },
        "abilities": [
          {
            "id": "integer (int64)",
            "skillId": "integer (int64)",
            "personId": "integer (int64)"
          }
        ],
        "absences": [
          {
            "id": "integer (int64)",
            "start": "integer (int64)",
            "end": "integer (int64)",
            "title": "string"
          }
        ]
      },
      "availability": [
        {
          "weeklyHours": "number (double)",
          "title": "string",
          "start": "integer (int64)",
          "end": "integer (int64)"
        }
      ]
    }
  ]
}
default

successful operation

Response Content-Types: application/json

Return the total entities count

GET /team/count
default

successful operation

Response Content-Types: application/json

Check the existence of the given ids

POST /team/exists
integer (int64)
Request Content-Types: application/json
Request Example
[
  "integer (int64)"
]
default

successful operation

Response Content-Types: application/json

Get entity by id

GET /team/{id}
id

(no description)

type
integer (int64)
in
path
200 OK

Entity found

Response Content-Types: application/json

Entity Update

POST /team/{id}
undefined
id

(no description)

type
integer (int64)
in
path
Request Content-Types: application/json
Request Example
{
  "id": "integer (int64)",
  "title": "string",
  "shareable": "boolean",
  "avatarUrl": "string",
  "resources": [
    {
      "id": "integer (int64)",
      "weeklyHours": "number (double)",
      "joinDate": "integer (int64)",
      "leaveDate": "integer (int64)",
      "teamId": "integer (int64)",
      "person": {
        "id": "integer (int64)",
        "title": "string",
        "avatarUrl": "string",
        "startDate": "integer (int64)",
        "endDate": "integer (int64)",
        "jiraUser": {
          "jiraUserId": "string",
          "title": "string",
          "email": "string",
          "avatarUrl": "string",
          "jiraUsername": "string"
        },
        "abilities": [
          {
            "id": "integer (int64)",
            "skillId": "integer (int64)",
            "personId": "integer (int64)"
          }
        ],
        "absences": [
          {
            "id": "integer (int64)",
            "start": "integer (int64)",
            "end": "integer (int64)",
            "title": "string"
          }
        ]
      },
      "availability": [
        {
          "weeklyHours": "number (double)",
          "title": "string",
          "start": "integer (int64)",
          "end": "integer (int64)"
        }
      ]
    }
  ]
}
default

successful operation

Response Content-Types: application/json

Entity Deletion

DELETE /team/{id}
id

(no description)

type
integer (int64)
in
path
default

successful operation

Response Content-Types: application/json

Schema Definitions

SkillDTO: object

id: integer (int64)
title: string
shareable: boolean false
Example
{
  "id": "integer (int64)",
  "title": "string",
  "shareable": "boolean"
}

ResourceAvailabilityDTO: object

weeklyHours: number (double)
title: string
start: integer (int64)
end: integer (int64)
Example
{
  "weeklyHours": "number (double)",
  "title": "string",
  "start": "integer (int64)",
  "end": "integer (int64)"
}

PersonDTO: object

id: integer (int64)
title: string
avatarUrl: string
startDate: integer (int64)
endDate: integer (int64)
jiraUser: JiraUserDTO
abilities: AbilityDTO
absences: AbsenceDTO
Example
{
  "id": "integer (int64)",
  "title": "string",
  "avatarUrl": "string",
  "startDate": "integer (int64)",
  "endDate": "integer (int64)",
  "jiraUser": {
    "jiraUserId": "string",
    "title": "string",
    "email": "string",
    "avatarUrl": "string",
    "jiraUsername": "string"
  },
  "abilities": [
    {
      "id": "integer (int64)",
      "skillId": "integer (int64)",
      "personId": "integer (int64)"
    }
  ],
  "absences": [
    {
      "id": "integer (int64)",
      "start": "integer (int64)",
      "end": "integer (int64)",
      "title": "string"
    }
  ]
}

AbilityDTO: object

id: integer (int64)
skillId: integer (int64)
personId: integer (int64)
Example
{
  "id": "integer (int64)",
  "skillId": "integer (int64)",
  "personId": "integer (int64)"
}

AbsenceDTO: object

id: integer (int64)
start: integer (int64)
end: integer (int64)
title: string
Example
{
  "id": "integer (int64)",
  "start": "integer (int64)",
  "end": "integer (int64)",
  "title": "string"
}

TeamDTO: object

id: integer (int64)
title: string
shareable: boolean false
avatarUrl: string
resources: ResourceDTO
Example
{
  "id": "integer (int64)",
  "title": "string",
  "shareable": "boolean",
  "avatarUrl": "string",
  "resources": [
    {
      "id": "integer (int64)",
      "weeklyHours": "number (double)",
      "joinDate": "integer (int64)",
      "leaveDate": "integer (int64)",
      "teamId": "integer (int64)",
      "person": {
        "id": "integer (int64)",
        "title": "string",
        "avatarUrl": "string",
        "startDate": "integer (int64)",
        "endDate": "integer (int64)",
        "jiraUser": {
          "jiraUserId": "string",
          "title": "string",
          "email": "string",
          "avatarUrl": "string",
          "jiraUsername": "string"
        },
        "abilities": [
          {
            "id": "integer (int64)",
            "skillId": "integer (int64)",
            "personId": "integer (int64)"
          }
        ],
        "absences": [
          {
            "id": "integer (int64)",
            "start": "integer (int64)",
            "end": "integer (int64)",
            "title": "string"
          }
        ]
      },
      "availability": [
        {
          "weeklyHours": "number (double)",
          "title": "string",
          "start": "integer (int64)",
          "end": "integer (int64)"
        }
      ]
    }
  ]
}

JiraUserDTO: object

jiraUserId: string
title: string
email: string
avatarUrl: string
jiraUsername: string
Example
{
  "jiraUserId": "string",
  "title": "string",
  "email": "string",
  "avatarUrl": "string",
  "jiraUsername": "string"
}

ResourceDTO: object

id: integer (int64)
weeklyHours: number (double)
joinDate: integer (int64)
leaveDate: integer (int64)
teamId: integer (int64)
person: PersonDTO
availability: ResourceAvailabilityDTO
Example
{
  "id": "integer (int64)",
  "weeklyHours": "number (double)",
  "joinDate": "integer (int64)",
  "leaveDate": "integer (int64)",
  "teamId": "integer (int64)",
  "person": {
    "id": "integer (int64)",
    "title": "string",
    "avatarUrl": "string",
    "startDate": "integer (int64)",
    "endDate": "integer (int64)",
    "jiraUser": {
      "jiraUserId": "string",
      "title": "string",
      "email": "string",
      "avatarUrl": "string",
      "jiraUsername": "string"
    },
    "abilities": [
      {
        "id": "integer (int64)",
        "skillId": "integer (int64)",
        "personId": "integer (int64)"
      }
    ],
    "absences": [
      {
        "id": "integer (int64)",
        "start": "integer (int64)",
        "end": "integer (int64)",
        "title": "string"
      }
    ]
  },
  "availability": [
    {
      "weeklyHours": "number (double)",
      "title": "string",
      "start": "integer (int64)",
      "end": "integer (int64)"
    }
  ]
}