openapi: 3.0.1
info:
contact:
name: Polarion REST API Support
url: https://support.sw.siemens.com/
description:
About
The Polarion REST API lets you interact with Polarion programmatically. Use this API to integrate Polarion with your applications. This page documents the REST resources, including the HTTP response codes and example requests and responses.
For a detailed description of the REST API and how to use it, see the REST API User Guide (available on Support Center).
license:
name: Apache 2.0
url: http://www.apache.org/licenses/LICENSE-2.0.html
title: Polarion REST Account Linked Work Items API
version: v1
servers:
- url: https://example.com/polarion/rest/v1
security:
- bearerAuth: []
tags:
- name: Linked Work Items
paths:
/projects/{projectId}/workitems/{workItemId}/backlinkedworkitems:
get:
description: Returns the incoming links from other Work Items (also known as backlinks). Does not pertain to External links.
operationId: getBacklinkedWorkItems
parameters:
- name: projectId
in: path
description: The Project ID.
required: true
schema:
type: string
- name: workItemId
in: path
description: The Work Item ID.
required: true
schema:
type: string
- name: page[size]
in: query
description: Limit the number of entities returned in a single response. See REST API User Guide for details.
schema:
type: integer
format: int32
- name: page[number]
in: query
description: Specify the page number to be returned. Counting starts from 1. See REST API User Guide for details.
schema:
type: integer
format: int32
- name: fields
in: query
description: Filter returned resource fields. See REST API User Guide for details.
style: deepObject
schema:
$ref: '#/components/schemas/sparseFields'
- name: include
in: query
description: Include related entities. See REST API User Guide for details.
schema:
type: string
- name: revision
in: query
description: The revision ID.
schema:
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/linkedworkitemsListGetResponse'
description: OK
'400':
description: Bad Request
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
'406':
description: Not Acceptable
4XX-5XX:
content:
application/json:
schema:
$ref: '#/components/schemas/errors'
description: 'Error responses have the following structure:'
'500':
description: Internal Server Error
'503':
description: Service Unavailable
summary: Returns a list of Backlinked Work Items.
tags:
- Linked Work Items
post:
description: Creates incoming links from other Work Items (backlinks). Does not pertain to External links.
operationId: postBacklinkedWorkItems
parameters:
- name: projectId
in: path
description: The Project ID.
required: true
schema:
type: string
- name: workItemId
in: path
description: The Work Item ID.
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/backlinkedworkitemsListPostRequest'
description: The Linked Work Item(s) body.
required: true
responses:
'201':
content:
application/json:
schema:
$ref: '#/components/schemas/linkedworkitemsListPostResponse'
description: OK
'400':
description: Bad Request
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
'406':
description: Not Acceptable
'409':
description: Conflict
'413':
description: Request Entity Too Large
'415':
description: Unsupported Media Type
4XX-5XX:
content:
application/json:
schema:
$ref: '#/components/schemas/errors'
description: 'Error responses have the following structure:'
'500':
description: Internal Server Error
'503':
description: Service Unavailable
summary: Creates a list of Backlinked Work Items.
tags:
- Linked Work Items
/projects/{projectId}/workitems/{workItemId}/linkedworkitems:
delete:
description: Deletes the direct outgoing links to other Work Items. (The same as the corresponding Java API method.) Does not pertain to external links or backlinks.
operationId: deleteLinkedWorkItems
parameters:
- name: projectId
in: path
description: The Project ID.
required: true
schema:
type: string
- name: workItemId
in: path
description: The Work Item ID.
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/linkedworkitemsListDeleteRequest'
description: The Linked Work Item(s) body.
required: true
responses:
'204':
description: No Content
'400':
description: Bad Request
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
'409':
description: Conflict
'413':
description: Request Entity Too Large
'415':
description: Unsupported Media Type
4XX-5XX:
content:
application/json:
schema:
$ref: '#/components/schemas/errors'
description: 'Error responses have the following structure:'
'500':
description: Internal Server Error
'503':
description: Service Unavailable
summary: Deletes a list of Linked Work Items.
tags:
- Linked Work Items
get:
description: Returns the direct outgoing links to other Work Items. (The same as the corresponding Java API method.) Does not pertain to external links or backlinks.
operationId: getLinkedWorkItems
parameters:
- name: projectId
in: path
description: The Project ID.
required: true
schema:
type: string
- name: workItemId
in: path
description: The Work Item ID.
required: true
schema:
type: string
- name: page[size]
in: query
description: Limit the number of entities returned in a single response. See REST API User Guide for details.
schema:
type: integer
format: int32
- name: page[number]
in: query
description: Specify the page number to be returned. Counting starts from 1. See REST API User Guide for details.
schema:
type: integer
format: int32
- name: fields
in: query
description: Filter returned resource fields. See REST API User Guide for details.
style: deepObject
schema:
$ref: '#/components/schemas/sparseFields'
- name: include
in: query
description: Include related entities. See REST API User Guide for details.
schema:
type: string
- name: revision
in: query
description: The revision ID.
schema:
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/linkedworkitemsListGetResponse'
description: OK
'400':
description: Bad Request
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
'406':
description: Not Acceptable
4XX-5XX:
content:
application/json:
schema:
$ref: '#/components/schemas/errors'
description: 'Error responses have the following structure:'
'500':
description: Internal Server Error
'503':
description: Service Unavailable
summary: Returns a list of Linked Work Items.
tags:
- Linked Work Items
post:
description: Creates the direct outgoing links to other Work Items. (The same as the corresponding Java API method.) Does not pertain to external links or backlinks.
operationId: postLinkedWorkItems
parameters:
- name: projectId
in: path
description: The Project ID.
required: true
schema:
type: string
- name: workItemId
in: path
description: The Work Item ID.
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/linkedworkitemsListPostRequest'
description: The Linked Work Item(s) body.
required: true
responses:
'201':
content:
application/json:
schema:
$ref: '#/components/schemas/linkedworkitemsListPostResponse'
description: OK
'400':
description: Bad Request
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
'406':
description: Not Acceptable
'409':
description: Conflict
'413':
description: Request Entity Too Large
'415':
description: Unsupported Media Type
4XX-5XX:
content:
application/json:
schema:
$ref: '#/components/schemas/errors'
description: 'Error responses have the following structure:'
'500':
description: Internal Server Error
'503':
description: Service Unavailable
summary: Creates a list of Linked Work Items.
tags:
- Linked Work Items
/projects/{projectId}/workitems/{workItemId}/linkedworkitems/{roleId}/{targetProjectId}/{linkedWorkItemId}:
delete:
description: Deletes the direct outgoing links to other Work Items. (The same as the corresponding Java API method.) Does not pertain to external links or backlinks.
operationId: deleteLinkedWorkItem
parameters:
- name: projectId
in: path
description: The Project ID.
required: true
schema:
type: string
- name: workItemId
in: path
description: The Work Item ID.
required: true
schema:
type: string
- name: roleId
in: path
description: The Role ID.
required: true
schema:
type: string
- name: targetProjectId
in: path
description: The Target Project ID.
required: true
schema:
type: string
- name: linkedWorkItemId
in: path
description: The Linked Work Item ID.
required: true
schema:
type: string
responses:
'204':
description: No Content
'400':
description: Bad Request
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
'409':
description: Conflict
4XX-5XX:
content:
application/json:
schema:
$ref: '#/components/schemas/errors'
description: 'Error responses have the following structure:'
'500':
description: Internal Server Error
'503':
description: Service Unavailable
summary: Deletes the specified Linked Work Item.
tags:
- Linked Work Items
get:
description: Returns the direct outgoing links to other Work Items. (The same as the corresponding Java API method.) Does not pertain to external links or backlinks.
operationId: getLinkedWorkItem
parameters:
- name: projectId
in: path
description: The Project ID.
required: true
schema:
type: string
- name: workItemId
in: path
description: The Work Item ID.
required: true
schema:
type: string
- name: roleId
in: path
description: The Role ID.
required: true
schema:
type: string
- name: targetProjectId
in: path
description: The Target Project ID.
required: true
schema:
type: string
- name: linkedWorkItemId
in: path
description: The Linked Work Item ID.
required: true
schema:
type: string
- name: fields
in: query
description: Filter returned resource fields. See REST API User Guide for details.
style: deepObject
schema:
$ref: '#/components/schemas/sparseFields'
- name: include
in: query
description: Include related entities. See REST API User Guide for details.
schema:
type: string
- name: revision
in: query
description: The revision ID.
schema:
type: string
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/linkedworkitemsSingleGetResponse'
description: OK
'400':
description: Bad Request
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
'406':
description: Not Acceptable
4XX-5XX:
content:
application/json:
schema:
$ref: '#/components/schemas/errors'
description: 'Error responses have the following structure:'
'500':
description: Internal Server Error
'503':
description: Service Unavailable
summary: Returns the specified Linked Work Item.
tags:
- Linked Work Items
patch:
description: Updates the direct outgoing links to other Work Items. (The same as the corresponding Java API method.) Does not pertain to external links or backlinks.
operationId: patchLinkedWorkItem
parameters:
- name: projectId
in: path
description: The Project ID.
required: true
schema:
type: string
- name: workItemId
in: path
description: The Work Item ID.
required: true
schema:
type: string
- name: roleId
in: path
description: The Role ID.
required: true
schema:
type: string
- name: targetProjectId
in: path
description: The Target Project ID.
required: true
schema:
type: string
- name: linkedWorkItemId
in: path
description: The Linked Work Item ID.
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/linkedworkitemsSinglePatchRequest'
description: The Linked Work Item(s) body.
required: true
responses:
'204':
description: No Content
'400':
description: Bad Request
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not Found
'409':
description: Conflict
'413':
description: Request Entity Too Large
'415':
description: Unsupported Media Type
4XX-5XX:
content:
application/json:
schema:
$ref: '#/components/schemas/errors'
description: 'Error responses have the following structure:'
'500':
description: Internal Server Error
'503':
description: Service Unavailable
summary: Updates the specified Linked Work Item.
tags:
- Linked Work Items
components:
schemas:
linkedworkitemsListGetResponse:
properties:
data:
items:
properties:
type:
enum:
- linkedworkitems
type: string
id:
example: MyProjectId/MyWorkItemId/parent/MyProjectId/MyLinkedWorkItemId
type: string
revision:
example: '1234'
type: string
attributes:
properties:
revision:
example: '1234'
type: string
role:
example: relates_to
type: string
suspect:
type: boolean
type: object
relationships:
properties:
sourceWorkItem:
properties:
data:
properties:
id:
example: MyProjectId/MyWorkItemId
type: string
revision:
example: '1234'
type: string
type:
enum:
- workitems
type: string
type: object
type: object
workItem:
properties:
data:
properties:
id:
example: MyProjectId/MyWorkItemId
type: string
revision:
example: '1234'
type: string
type:
enum:
- workitems
type: string
type: object
type: object
type: object
links:
properties:
self:
example: server-host-name/application-path/projects/MyProjectId/workitems/MyWorkItemId/linkedworkitems/parent/MyProjectId/MyLinkedWorkItemId?revision=1234
type: string
type: object
meta:
properties:
errors:
items:
properties:
detail:
description: Human-readable explanation specific to this occurrence of the problem.
example: 'Unexpected token, BEGIN_ARRAY expected, but was : BEGIN_OBJECT (at $.data)'
type: string
source:
properties:
parameter:
description: String indicating which URI query parameter caused the error.
example: revision
type: string
pointer:
description: JSON Pointer to the associated entity in the request document.
example: $.data
type: string
resource:
description: Resource causing the error.
properties:
id:
example: MyProjectId/id
type: string
type:
example: type
type: string
type: object
type: object
status:
description: HTTP status code applicable to this problem.
example: '400'
type: string
title:
description: Short, human-readable summary of the problem.
example: Bad Request
type: string
type: object
type: array
type: object
type: object
type: array
included:
description: Related entities might be returned, see REST API User Guide.
items:
type: object
type: array
links:
properties:
first:
example: server-host-name/application-path/projects/MyProjectId/workitems/MyWorkItemId/linkedworkitems/parent/MyProjectId?page%5Bsize%5D=10&page%5Bnumber%5D=1
type: string
last:
example: server-host-name/application-path/projects/MyProjectId/workitems/MyWorkItemId/linkedworkitems/parent/MyProjectId?page%5Bsize%5D=10&page%5Bnumber%5D=9
type: string
next:
example: server-host-name/application-path/projects/MyProjectId/workitems/MyWorkItemId/linkedworkitems/parent/MyProjectId?page%5Bsize%5D=10&page%5Bnumber%5D=6
type: string
prev:
example: server-host-name/application-path/projects/MyProjectId/workitems/MyWorkItemId/linkedworkitems/parent/MyProjectId?page%5Bsize%5D=10&page%5Bnumber%5D=4
type: string
self:
example: server-host-name/application-path/projects/MyProjectId/workitems/MyWorkItemId/linkedworkitems/parent/MyProjectId?page%5Bsize%5D=10&page%5Bnumber%5D=5
type: string
type: object
meta:
properties:
totalCount:
format: int32
type: integer
type: object
type: object
linkedworkitemsListPostResponse:
properties:
data:
items:
properties:
type:
enum:
- linkedworkitems
type: string
id:
example: MyProjectId/MyWorkItemId/parent/MyProjectId/MyLinkedWorkItemId
type: string
links:
properties:
self:
example: server-host-name/application-path/projects/MyProjectId/workitems/MyWorkItemId/linkedworkitems/parent/MyProjectId/MyLinkedWorkItemId?revision=1234
type: string
type: object
type: object
type: array
type: object
linkedworkitemsSingleGetResponse:
properties:
data:
properties:
type:
enum:
- linkedworkitems
type: string
id:
example: MyProjectId/MyWorkItemId/parent/MyProjectId/MyLinkedWorkItemId
type: string
revision:
example: '1234'
type: string
attributes:
properties:
revision:
example: '1234'
type: string
role:
example: relates_to
type: string
suspect:
type: boolean
type: object
relationships:
properties:
sourceWorkItem:
properties:
data:
properties:
id:
example: MyProjectId/MyWorkItemId
type: string
revision:
example: '1234'
type: string
type:
enum:
- workitems
type: string
type: object
type: object
workItem:
properties:
data:
properties:
id:
example: MyProjectId/MyWorkItemId
type: string
revision:
example: '1234'
type: string
type:
enum:
- workitems
type: string
type: object
type: object
type: object
links:
properties:
self:
example: server-host-name/application-path/projects/MyProjectId/workitems/MyWorkItemId/linkedworkitems/parent/MyProjectId/MyLinkedWorkItemId?revision=1234
type: string
type: object
meta:
properties:
errors:
items:
properties:
detail:
description: Human-readable explanation specific to this occurrence of the problem.
example: 'Unexpected token, BEGIN_ARRAY expected, but was : BEGIN_OBJECT (at $.data)'
type: string
source:
properties:
parameter:
description: String indicating which URI query parameter caused the error.
example: revision
type: string
pointer:
description: JSON Pointer to the associated entity in the request document.
example: $.data
type: string
resource:
description: Resource causing the error.
properties:
id:
example: MyProjectId/id
type: string
type:
example: type
type: string
type: object
type: object
status:
description: HTTP status code applicable to this problem.
example: '400'
type: string
title:
description: Short, human-readable summary of the problem.
example: Bad Request
type: string
type: object
type: array
type: object
type: object
included:
description: Related entities might be returned, see REST API User Guide.
items:
type: object
type: array
links:
properties:
self:
example: server-host-name/application-path/projects/MyProjectId/workitems/MyWorkItemId/linkedworkitems/parent/MyProjectId/MyLinkedWorkItemId?revision=1234
type: string
type: object
type: object
backlinkedworkitemsListPostRequest:
properties:
data:
items:
properties:
type:
enum:
- linkedworkitems
type: string
attributes:
properties:
revision:
example: '1234'
type: string
role:
example: relates_to
type: string
suspect:
type: boolean
type: object
relationships:
properties:
sourceWorkItem:
properties:
data:
properties:
id:
example: MyProjectId/MyWorkItemId
type: string
type:
enum:
- workitems
type: string
type: object
type: object
type: object
type: object
type: array
type: object
sparseFields:
properties:
categories:
description: Requested fields
example: '@all'
type: string
collections:
description: Requested fields
example: '@all'
type: string
customfields:
description: Requested fields
example: '@all'
type: string
document_attachments:
description: Requested fields
example: '@all'
type: string
document_comments:
description: Requested fields
example: '@all'
type: string
document_parts:
description: Requested fields
example: '@all'
type: string
documents:
description: Requested fields
example: '@all'
type: string
enumerations:
description: Requested fields
example: '@all'
type: string
externallylinkedworkitems:
description: Requested fields
example: '@all'
type: string
featureselections:
description: Requested fields
example: '@all'
type: string
globalroles:
description: Requested fields
example: '@all'
type: string
icons:
description: Requested fields
example: '@all'
type: string
jobs:
description: Requested fields
example: '@all'
type: string
license:
description: Requested fields
example: '@all'
type: string
license_assignments:
description: Requested fields
example: '@all'
type: string
license_slots:
description: Requested fields
example: '@all'
type: string
license_types:
description: Requested fields
example: '@all'
type: string
linkedoslcresources:
description: Requested fields
example: '@all'
type: string
linkedworkitems:
description: Requested fields
example: '@all'
type: string
metadata:
description: Requested fields
example: '@all'
type: string
page_attachments:
description: Requested fields
example: '@all'
type: string
page_comments:
description: Requested fields
example: '@all'
type: string
pages:
description: Requested fields
example: '@all'
type: string
plans:
description: Requested fields
example: '@all'
type: string
projectroles:
description: Requested fields
example: '@all'
type: string
projects:
description: Requested fields
example: '@all'
type: string
projecttemplates:
description: Requested fields
example: '@all'
type: string
revisions:
description: Requested fields
example: '@all'
type: string
testparameter_definitions:
description: Requested fields
example: '@all'
type: string
testparameters:
description: Requested fields
example: '@all'
type: string
testrecord_attachments:
description: Requested fields
example: '@all'
type: string
testrecords:
description: Requested fields
example: '@all'
type: string
testrun_attachments:
description: Requested fields
example: '@all'
type: string
testrun_comments:
description: Requested fields
example: '@all'
type: string
testruns:
description: Requested fields
example: '@all'
type: string
teststep_results:
description: Requested fields
example: '@all'
type: string
teststepresult_attachments:
description: Requested fields
example: '@all'
type: string
teststeps:
description: Requested fields
example: '@all'
type: string
usergroups:
description: Requested fields
example: '@all'
type: string
users:
description: Requested fields
example: '@all'
type: string
workitem_approvals:
description: Requested fields
example: '@all'
type: string
workitem_attachments:
description: Requested fields
example: '@all'
type: string
workitem_comments:
description: Requested fields
example: '@all'
type: string
workitems:
description: Requested fields
example: '@all'
type: string
workrecords:
description: Requested fields
example: '@all'
type: string
type: object
linkedworkitemsSinglePatchRequest:
properties:
data:
properties:
type:
enum:
- linkedworkitems
type: string
id:
example: MyProjectId/MyWorkItemId/parent/MyProjectId/MyLinkedWorkItemId
type: string
attributes:
properties:
revision:
example: '1234'
type: string
suspect:
type: boolean
type: object
type: object
type: object
linkedworkitemsListDeleteRequest:
properties:
data:
items:
properties:
type:
enum:
- linkedworkitems
type: string
id:
example: MyProjectId/MyWorkItemId/parent/MyProjectId/MyLinkedWorkItemId
type: string
type: object
type: array
type: object
errors:
properties:
errors:
items:
properties:
status:
description: HTTP status code applicable to this problem.
example: '400'
type: string
title:
description: Short, human-readable summary of the problem.
example: Bad Request
type: string
detail:
description: Human-readable explanation specific to this occurrence of the problem.
example: 'Unexpected token, BEGIN_ARRAY expected, but was : BEGIN_OBJECT (at $.data)'
type: string
source:
properties:
parameter:
description: String indicating which URI query parameter caused the error.
example: revision
type: string
pointer:
description: JSON Pointer to the associated entity in the request document.
example: $.data
type: string
resource:
description: Resource causing the error.
properties:
id:
example: MyProjectId/id
type: string
type:
example: type
type: string
type: object
type: object
type: object
type: array
type: object
linkedworkitemsListPostRequest:
properties:
data:
items:
properties:
type:
enum:
- linkedworkitems
type: string
attributes:
properties:
revision:
example: '1234'
type: string
role:
example: relates_to
type: string
suspect:
type: boolean
type: object
relationships:
properties:
workItem:
properties:
data:
properties:
id:
example: MyProjectId/MyWorkItemId
type: string
type:
enum:
- workitems
type: string
type: object
type: object
type: object
type: object
type: array
type: object
securitySchemes:
bearerAuth:
bearerFormat: JWT
scheme: bearer
type: http