Portfolio for Jira - Public API API Reference

Welcome to the Portfolio for Jira Public API REST documentation. In order to access the endpoints you have to authenticate your REST calls.

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

Schemes: http
Version: v1

hierarchy

Return the total entity count.

GET /hierarchy/count
default

successful operation

Response Content-Types: application/json

Get entity by ID.

GET /hierarchy/{id}
id: integer (int64)
in path

(no description)

200 OK

Entity found

Response Content-Types: application/json

Entity Update.

POST /hierarchy/{id}
id: integer (int64)
in path

(no description)

Request Content-Types: application/json
Request Example
{
  "id": "integer (int64)",
  "title": "string",
  "issueTypeIds": [
    "string"
  ]
}
default

successful operation

Response Content-Types: application/json

Entity Deletion.

DELETE /hierarchy/{id}
id: integer (int64)
in path

(no description)

default

successful operation

Response Content-Types: application/json

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

GET /hierarchy
page: integer (int32)
in query

(no description)

size: integer (int32)
in query

(no description)

ids: integer[]
in query

(no description)

Array values passed as multiple parameters: ?ids=aaa&ids=bbb
default

successful operation

Response Content-Types: application/json

Entity creation operation. Returns the new entity ID.

POST /hierarchy
Request Content-Types: application/json
Request Example
{
  "id": "integer (int64)",
  "title": "string",
  "issueTypeIds": [
    "string"
  ]
}
default

successful operation

Response Content-Types: application/json

Check the existence of the given IDs.

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

successful operation

Response Content-Types: application/json

nonworkingday

GET /nonworkingday/plan/{planId}

planId: integer (int64)
in path

(no description)

200 OK

Entity found

Response Content-Types: application/json

Return the total entity count.

GET /nonworkingday/count
default

successful operation

Response Content-Types: application/json

Get entity by ID.

GET /nonworkingday/{id}
id: integer (int64)
in path

(no description)

200 OK

Entity found

Response Content-Types: application/json

Entity Update.

POST /nonworkingday/{id}
id: integer (int64)
in path

(no description)

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

successful operation

Response Content-Types: application/json

Entity Deletion.

DELETE /nonworkingday/{id}
id: integer (int64)
in path

(no description)

default

successful operation

Response Content-Types: application/json

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

GET /nonworkingday
page: integer (int32)
in query

(no description)

size: integer (int32)
in query

(no description)

ids: integer[]
in query

(no description)

Array values passed as multiple parameters: ?ids=aaa&ids=bbb
default

successful operation

Response Content-Types: application/json

Entity creation operation. Returns the new entity ID.

POST /nonworkingday
Request Content-Types: application/json
Request Example
{
  "id": "integer (int64)",
  "planId": "integer (int64)",
  "title": "string",
  "start": "integer (int64)",
  "end": "integer (int64)"
}
default

successful operation

Response Content-Types: application/json

Check the existence of the given IDs.

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

successful operation

Response Content-Types: application/json

plan

Return the total entity count.

GET /plan/count
default

successful operation

Response Content-Types: application/json

Get entity by ID.

GET /plan/{id}
id: integer (int64)
in path

(no description)

200 OK

Entity found

Response Content-Types: application/json

Entity Update.

POST /plan/{id}
id: integer (int64)
in path

(no description)

Request Content-Types: application/json
Request Example
{
  "id": "integer (int64)",
  "planId": "integer (int64)",
  "nonWorkingDays": [
    {
      "id": "integer (int64)",
      "planId": "integer (int64)",
      "title": "string",
      "start": "integer (int64)",
      "end": "integer (int64)"
    }
  ],
  "planTeams": [
    "integer (int64)"
  ],
  "excludedVersions": [
    "integer (int64)"
  ],
  "heuristicThreshold": "integer (int32)",
  "globalSprintLength": "integer (int32)",
  "weekdayConfiguration": [
    "integer (int32)"
  ],
  "title": "string",
  "timeZone": "string",
  "defaultTeamWeeklyCapacity": "number (double)",
  "globalDefaultVelocity": "number (double)",
  "hoursPerDay": "number (double)",
  "hasSprintConstraint": "boolean",
  "strictStageDivision": "boolean",
  "multiScenarioEnabled": "boolean",
  "syncStartEnabled": "boolean",
  "commitIssueAssignee": "boolean",
  "minLoadUnstrEpics": "integer (int64)",
  "maxResourcesPerStory": "integer (int64)",
  "assigneeSchedulingLevel": "integer (int64)",
  "schedulingVerbosity": "integer (int64)",
  "unestimatedIssuesOption": "integer (int64)",
  "schedulingStartCustomField": "integer (int64)",
  "schedulingEndCustomField": "integer (int64)",
  "dependencyModeOption": "integer (int64)",
  "planningUnit": "integer (int64)",
  "programId": "integer (int64)",
  "portfolioPlanVersion": "integer (int64)"
}
default

successful operation

Response Content-Types: application/json

Entity Deletion.

DELETE /plan/{id}
id: integer (int64)
in path

(no description)

default

successful operation

Response Content-Types: application/json

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

GET /plan
page: integer (int32)
in query

(no description)

size: integer (int32)
in query

(no description)

ids: integer[]
in query

(no description)

Array values passed as multiple parameters: ?ids=aaa&ids=bbb
default

successful operation

Response Content-Types: application/json

Entity creation operation. Returns the new entity ID.

POST /plan
Request Content-Types: application/json
Request Example
{
  "id": "integer (int64)",
  "planId": "integer (int64)",
  "nonWorkingDays": [
    {
      "id": "integer (int64)",
      "planId": "integer (int64)",
      "title": "string",
      "start": "integer (int64)",
      "end": "integer (int64)"
    }
  ],
  "planTeams": [
    "integer (int64)"
  ],
  "excludedVersions": [
    "integer (int64)"
  ],
  "heuristicThreshold": "integer (int32)",
  "globalSprintLength": "integer (int32)",
  "weekdayConfiguration": [
    "integer (int32)"
  ],
  "title": "string",
  "timeZone": "string",
  "defaultTeamWeeklyCapacity": "number (double)",
  "globalDefaultVelocity": "number (double)",
  "hoursPerDay": "number (double)",
  "hasSprintConstraint": "boolean",
  "strictStageDivision": "boolean",
  "multiScenarioEnabled": "boolean",
  "syncStartEnabled": "boolean",
  "commitIssueAssignee": "boolean",
  "minLoadUnstrEpics": "integer (int64)",
  "maxResourcesPerStory": "integer (int64)",
  "assigneeSchedulingLevel": "integer (int64)",
  "schedulingVerbosity": "integer (int64)",
  "unestimatedIssuesOption": "integer (int64)",
  "schedulingStartCustomField": "integer (int64)",
  "schedulingEndCustomField": "integer (int64)",
  "dependencyModeOption": "integer (int64)",
  "planningUnit": "integer (int64)",
  "programId": "integer (int64)",
  "portfolioPlanVersion": "integer (int64)"
}
default

successful operation

Response Content-Types: application/json

Check the existence of the given IDs.

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

successful operation

Response Content-Types: application/json

program

Return the total entity count.

GET /program/count
default

successful operation

Response Content-Types: application/json

Get entity by ID.

GET /program/{id}
id: integer (int64)
in path

(no description)

200 OK

Entity found

Response Content-Types: application/json

Entity Update.

POST /program/{id}
id: integer (int64)
in path

(no description)

Request Content-Types: application/json
Request Example
{
  "id": "integer (int64)",
  "title": "string",
  "owner": "string",
  "description": "string"
}
default

successful operation

Response Content-Types: application/json

Entity Deletion.

DELETE /program/{id}
id: integer (int64)
in path

(no description)

default

successful operation

Response Content-Types: application/json

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

GET /program
page: integer (int32)
in query

(no description)

size: integer (int32)
in query

(no description)

ids: integer[]
in query

(no description)

Array values passed as multiple parameters: ?ids=aaa&ids=bbb
default

successful operation

Response Content-Types: application/json

Entity creation operation. Returns the new entity ID.

POST /program
Request Content-Types: application/json
Request Example
{
  "id": "integer (int64)",
  "title": "string",
  "owner": "string",
  "description": "string"
}
default

successful operation

Response Content-Types: application/json

Check the existence of the given IDs.

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

successful operation

Response Content-Types: application/json

stage

Return the total entity count.

GET /stage/count
default

successful operation

Response Content-Types: application/json

Get entity by ID.

GET /stage/{id}
id: integer (int64)
in path

(no description)

200 OK

Entity found

Response Content-Types: application/json

Entity Update.

POST /stage/{id}
id: integer (int64)
in path

(no description)

Request Content-Types: application/json
Request Example
{
  "id": "integer (int64)",
  "planId": "integer (int64)",
  "title": "string",
  "skillId": "integer (int64)",
  "weight": "number (double)",
  "color": "string"
}
default

successful operation

Response Content-Types: application/json

Entity Deletion.

DELETE /stage/{id}
id: integer (int64)
in path

(no description)

default

successful operation

Response Content-Types: application/json

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

GET /stage
page: integer (int32)
in query

(no description)

size: integer (int32)
in query

(no description)

ids: integer[]
in query

(no description)

Array values passed as multiple parameters: ?ids=aaa&ids=bbb
default

successful operation

Response Content-Types: application/json

Entity creation operation. Returns the new entity ID.

POST /stage
Request Content-Types: application/json
Request Example
{
  "id": "integer (int64)",
  "planId": "integer (int64)",
  "title": "string",
  "skillId": "integer (int64)",
  "weight": "number (double)",
  "color": "string"
}
default

successful operation

Response Content-Types: application/json

Check the existence of the given IDs.

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

successful operation

Response Content-Types: application/json

Schema Definitions

HierarchyLevelDTO: object

id: integer (int64)
title: string
issueTypeIds: string[]
string
Example
{
  "id": "integer (int64)",
  "title": "string",
  "issueTypeIds": [
    "string"
  ]
}

NonWorkingDayDTO: object

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

PlanDTO: object

id: integer (int64)
planId: integer (int64)
nonWorkingDays: NonWorkingDayDTO
NonWorkingDayDTO
planTeams: integer[]
integer (int64)
excludedVersions: integer[]
integer (int64)
heuristicThreshold: integer (int32)
globalSprintLength: integer (int32)
weekdayConfiguration: integer[]
integer (int32)
title: string
timeZone: string
defaultTeamWeeklyCapacity: number (double)
globalDefaultVelocity: number (double)
hoursPerDay: number (double)
hasSprintConstraint: boolean
strictStageDivision: boolean
multiScenarioEnabled: boolean
syncStartEnabled: boolean
commitIssueAssignee: boolean
minLoadUnstrEpics: integer (int64)
maxResourcesPerStory: integer (int64)
assigneeSchedulingLevel: integer (int64)
schedulingVerbosity: integer (int64)
unestimatedIssuesOption: integer (int64)
schedulingStartCustomField: integer (int64)
schedulingEndCustomField: integer (int64)
dependencyModeOption: integer (int64)
planningUnit: integer (int64)
programId: integer (int64)
portfolioPlanVersion: integer (int64)
Example
{
  "id": "integer (int64)",
  "planId": "integer (int64)",
  "nonWorkingDays": [
    {
      "id": "integer (int64)",
      "planId": "integer (int64)",
      "title": "string",
      "start": "integer (int64)",
      "end": "integer (int64)"
    }
  ],
  "planTeams": [
    "integer (int64)"
  ],
  "excludedVersions": [
    "integer (int64)"
  ],
  "heuristicThreshold": "integer (int32)",
  "globalSprintLength": "integer (int32)",
  "weekdayConfiguration": [
    "integer (int32)"
  ],
  "title": "string",
  "timeZone": "string",
  "defaultTeamWeeklyCapacity": "number (double)",
  "globalDefaultVelocity": "number (double)",
  "hoursPerDay": "number (double)",
  "hasSprintConstraint": "boolean",
  "strictStageDivision": "boolean",
  "multiScenarioEnabled": "boolean",
  "syncStartEnabled": "boolean",
  "commitIssueAssignee": "boolean",
  "minLoadUnstrEpics": "integer (int64)",
  "maxResourcesPerStory": "integer (int64)",
  "assigneeSchedulingLevel": "integer (int64)",
  "schedulingVerbosity": "integer (int64)",
  "unestimatedIssuesOption": "integer (int64)",
  "schedulingStartCustomField": "integer (int64)",
  "schedulingEndCustomField": "integer (int64)",
  "dependencyModeOption": "integer (int64)",
  "planningUnit": "integer (int64)",
  "programId": "integer (int64)",
  "portfolioPlanVersion": "integer (int64)"
}

ProgramDTO: object

id: integer (int64)
title: string
owner: string
description: string
Example
{
  "id": "integer (int64)",
  "title": "string",
  "owner": "string",
  "description": "string"
}

StageDTO: object

id: integer (int64)
planId: integer (int64)
title: string
skillId: integer (int64)
weight: number (double)
color: string
Example
{
  "id": "integer (int64)",
  "planId": "integer (int64)",
  "title": "string",
  "skillId": "integer (int64)",
  "weight": "number (double)",
  "color": "string"
}