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 Documents API version: v1 servers: - url: https://example.com/polarion/rest/v1 security: - bearerAuth: [] tags: - name: Documents paths: /all/documents: get: operationId: getAllDocuments parameters: - 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: query in: query description: The query string. schema: type: string - name: sort in: query description: The sort string. schema: type: string - name: revision in: query description: The revision ID. schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/documentsListGetResponse' 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 Documents from all Projects. tags: - Documents /all/documents/actions/branch: post: operationId: branchDocuments requestBody: content: application/json: schema: $ref: '#/components/schemas/branchDocumentsRequestBody' description: Branching parameters. required: true responses: '202': content: application/json: schema: $ref: '#/components/schemas/jobsSinglePostResponse' description: Accepted '400': description: Bad Request '401': description: Unauthorized '406': description: Not Acceptable '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 Branches of Documents. tags: - Documents /projects/{projectId}/documents: get: operationId: getDocuments parameters: - name: projectId in: path description: The Project 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: query in: query description: The query string. schema: type: string - name: sort in: query description: The sort string. schema: type: string - name: revision in: query description: The revision ID. schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/documentsListGetResponse' 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 Documents from the Project context. tags: - Documents /projects/{projectId}/documents/fields/{fieldId}/actions/getAvailableOptions: get: operationId: getAvailableEnumOptionsForDocumentType parameters: - name: projectId in: path description: The Project ID. required: true schema: type: string - name: fieldId in: path description: The Field 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: type in: query description: The Type of the object. Use '~' without quotes to represent no target Type. schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/enumOptionsActionResponseBody' 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 available options for the requested field for the specified Document type. tags: - Documents /projects/{projectId}/spaces/{spaceId}/documents: get: operationId: getSpaceDocuments parameters: - name: projectId in: path description: The Project ID. required: true schema: type: string - name: spaceId in: path description: The Space ID. (Use '_default' without quotes to address the default Space.) 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: query in: query description: The query string. schema: type: string - name: sort in: query description: The sort string. schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/documentsListGetResponse' 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 Documents from a given Project Space. tags: - Documents post: operationId: postDocuments parameters: - name: projectId in: path description: The Project ID. required: true schema: type: string - name: spaceId in: path description: The Space ID. (Use '_default' without quotes to address the default Space.) required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/documentsListPostRequest' description: The Document body. required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/documentsListPostResponse' description: Created '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 Documents. tags: - Documents /projects/{projectId}/spaces/{spaceId}/documents/{documentName}: get: operationId: getDocument parameters: - name: projectId in: path description: The Project ID. required: true schema: type: string - name: spaceId in: path description: The Space ID. (Use '_default' without quotes to address the default Space.) required: true schema: type: string - name: documentName in: path description: The Document name. 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/documentsSingleGetResponse' 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 Document. tags: - Documents patch: operationId: patchDocument parameters: - name: projectId in: path description: The Project ID. required: true schema: type: string - name: spaceId in: path description: The Space ID. (Use '_default' without quotes to address the default Space.) required: true schema: type: string - name: documentName in: path description: The Document name. required: true schema: type: string - name: workflowAction in: query description: The Workflow Action. schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/documentsSinglePatchRequest' description: The Document 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 Document. tags: - Documents /projects/{projectId}/spaces/{spaceId}/documents/{documentName}/actions/branch: post: operationId: branchDocument parameters: - name: projectId in: path description: The Project ID. required: true schema: type: string - name: spaceId in: path description: The Space ID. (Use '_default' without quotes to address the default Space.) required: true schema: type: string - name: documentName in: path description: The Document name. required: true schema: type: string - name: revision in: query description: The revision ID. schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/branchDocumentRequestBody' description: Branching parameters. required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/documentsSinglePostResponse' description: Created '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 Branch of the Document. tags: - Documents /projects/{projectId}/spaces/{spaceId}/documents/{documentName}/actions/copy: post: operationId: copyDocument parameters: - name: projectId in: path description: The Project ID. required: true schema: type: string - name: spaceId in: path description: The Space ID. (Use '_default' without quotes to address the default Space.) required: true schema: type: string - name: documentName in: path description: The Document name. required: true schema: type: string - name: revision in: query description: The revision ID. schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/copyDocumentRequestBody' description: Copy Document parameters. required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/documentsSinglePostResponse' description: Created '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 copy of the Document. tags: - Documents /projects/{projectId}/spaces/{spaceId}/documents/{documentName}/actions/mergeFromMaster: post: operationId: mergeDocumentFromMaster parameters: - name: projectId in: path description: The Project ID. required: true schema: type: string - name: spaceId in: path description: The Space ID. (Use '_default' without quotes to address the default Space.) required: true schema: type: string - name: documentName in: path description: The Branch Document Name. required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/mergeDocumentRequestBody' description: Merge Document parameters. responses: '202': content: application/json: schema: $ref: '#/components/schemas/jobsSinglePostResponse' description: Accepted '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: Merges Master Work Item changes to the specified Branched Document. tags: - Documents /projects/{projectId}/spaces/{spaceId}/documents/{documentName}/actions/mergeToMaster: post: operationId: mergeDocumentToMaster parameters: - name: projectId in: path description: The Project ID. required: true schema: type: string - name: spaceId in: path description: The Space ID. (Use '_default' without quotes to address the default Space.) required: true schema: type: string - name: documentName in: path description: The Branch Document Name. required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/mergeDocumentRequestBody' description: Merge Document parameters. responses: '202': content: application/json: schema: $ref: '#/components/schemas/jobsSinglePostResponse' description: Accepted '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: Merges Work Item changes from specified Branched Document to Master. tags: - Documents /projects/{projectId}/spaces/{spaceId}/documents/{documentName}/fields/{fieldId}/actions/getAvailableOptions: get: operationId: getAvailableEnumOptionsForDocument parameters: - name: projectId in: path description: The Project ID. required: true schema: type: string - name: spaceId in: path description: The Space ID. (Use '_default' without quotes to address the default Space.) required: true schema: type: string - name: documentName in: path description: The Document name. required: true schema: type: string - name: fieldId in: path description: The Field 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 responses: '200': content: application/json: schema: $ref: '#/components/schemas/enumOptionsActionResponseBody' 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 available options for the requested field in the specified Document. tags: - Documents /projects/{projectId}/spaces/{spaceId}/documents/{documentName}/fields/{fieldId}/actions/getCurrentOptions: get: operationId: getCurrentEnumerationOptionsForDocument parameters: - name: projectId in: path description: The Project ID. required: true schema: type: string - name: spaceId in: path description: The Space ID. (Use '_default' without quotes to address the default Space.) required: true schema: type: string - name: documentName in: path description: The Document name. required: true schema: type: string - name: fieldId in: path description: The Field 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: revision in: query description: The revision ID. schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/enumOptionsActionResponseBody' 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 selected options for the requested field in the specified Document. tags: - Documents components: schemas: documentsListPostRequest: properties: data: items: properties: type: enum: - documents type: string attributes: properties: autoSuspect: type: boolean homePageContent: properties: type: enum: - text/html - text/plain type: string value: example: My text value type: string type: object moduleName: example: MyDocumentId type: string outlineNumbering: properties: prefix: example: ABC type: string type: object renderingLayouts: items: properties: label: example: My label type: string layouter: example: paragraph type: string properties: items: properties: key: example: fieldsAtStart type: string value: example: id type: string type: object type: array type: example: task type: string type: object type: array status: example: draft type: string structureLinkRole: example: relates_to type: string title: example: Title type: string type: example: req_specification type: string usesOutlineNumbering: type: boolean type: object type: object type: array type: object mergeDocumentRequestBody: properties: createBaseline: description: Specifies whether the Baseline should be created. example: true type: boolean userFilter: description: Specifies the query to filter the source Work Items for the merge. example: status:open type: string type: object branchDocumentsRequestBody: properties: documentConfigurations: items: properties: copyWorkflowStatusAndSignatures: description: Specifies that workflow status and signatures should be copied to the branched document. example: false type: boolean initializedFields: description: Specifies fields of overwritten Work Items that should be initialized (instead of being copied from source Work Items). items: example: severity type: string type: array overwriteWorkItems: description: Specifies that Work Items in the branched Document should be overwritten (instead of being referenced). example: false type: boolean query: description: Specifies optional filtering query. example: status:open type: string sourceDocument: description: Reference path of the source Document. example: MyProjectId/MySpaceId/MyDocumentId type: string sourceRevision: description: Revision of the source Document. example: '1234' type: string targetDocumentName: description: Name for new Document. example: MyDocumentId type: string targetDocumentTitle: description: Title for new Document. example: My Document Title type: string targetProjectId: description: Project where new document will be created. example: MyProjectId type: string targetSpaceId: description: Space where new document will be created. example: MySpaceId type: string updateTitleHeading: description: Specifies that title heading of the target Document should be set to the new Document's title. example: false type: boolean required: - sourceDocument type: object minItems: 1 type: array required: - documentConfigurations type: object documentsListGetResponse: properties: data: items: properties: type: enum: - documents type: string id: example: MyProjectId/MySpaceId/MyDocumentId type: string revision: example: '1234' type: string attributes: properties: autoSuspect: type: boolean branchedWithInitializedFields: items: example: fieldId type: string type: array branchedWithQuery: example: Branched with Query type: string created: example: '1970-01-01T00:00:00Z' format: date-time type: string derivedFields: items: example: fieldId type: string type: array derivedFromLinkRole: example: relates_to type: string homePageContent: properties: type: enum: - text/html - text/plain type: string value: example: My text value type: string type: object moduleFolder: example: MySpaceId type: string moduleName: example: MyDocumentId type: string outlineNumbering: properties: prefix: example: ABC type: string type: object renderingLayouts: items: properties: label: example: My label type: string layouter: example: paragraph type: string properties: items: properties: key: example: fieldsAtStart type: string value: example: id type: string type: object type: array type: example: task type: string type: object type: array status: example: draft type: string structureLinkRole: example: relates_to type: string title: example: Title type: string type: example: req_specification type: string updated: example: '1970-01-01T00:00:00Z' format: date-time type: string usesOutlineNumbering: type: boolean type: object relationships: properties: attachments: properties: data: items: properties: id: example: MyProjectId/MySpaceId/MyDocumentId/MyAttachmentId type: string revision: example: '1234' type: string type: enum: - document_attachments type: string type: object type: array links: properties: related: example: server-host-name/application-path/projects/MyProjectId/spaces/MySpaceId/documents/MyDocumentId/attachments?revision=1234 type: string type: object meta: properties: totalCount: format: int32 type: integer type: object type: object author: properties: data: properties: id: example: MyUserId type: string revision: example: '1234' type: string type: enum: - users type: string type: object type: object branchedFrom: properties: data: properties: id: example: MyProjectId/MySpaceId/MyDocumentId type: string revision: example: '1234' type: string type: enum: - documents type: string type: object type: object comments: properties: data: items: properties: id: example: MyProjectId/MySpaceId/MyDocumentId/MyCommentId type: string revision: example: '1234' type: string type: enum: - document_comments type: string type: object type: array links: properties: related: example: server-host-name/application-path/projects/MyProjectId/spaces/MySpaceId/documents/MyDocumentId/comments?revision=1234 type: string type: object meta: properties: totalCount: format: int32 type: integer type: object type: object derivedFrom: properties: data: properties: id: example: MyProjectId/MySpaceId/MyDocumentId type: string revision: example: '1234' type: string type: enum: - documents type: string type: object type: object project: properties: data: properties: id: example: MyProjectId type: string revision: example: '1234' type: string type: enum: - projects type: string type: object type: object updatedBy: properties: data: properties: id: example: MyUserId type: string revision: example: '1234' type: string type: enum: - users type: string type: object type: object variant: 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/spaces/MySpaceId/documents/MyDocumentId?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/spaces/MySpaceId/documents?page%5Bsize%5D=10&page%5Bnumber%5D=1 type: string last: example: server-host-name/application-path/projects/MyProjectId/spaces/MySpaceId/documents?page%5Bsize%5D=10&page%5Bnumber%5D=9 type: string next: example: server-host-name/application-path/projects/MyProjectId/spaces/MySpaceId/documents?page%5Bsize%5D=10&page%5Bnumber%5D=6 type: string prev: example: server-host-name/application-path/projects/MyProjectId/spaces/MySpaceId/documents?page%5Bsize%5D=10&page%5Bnumber%5D=4 type: string self: example: server-host-name/application-path/projects/MyProjectId/spaces/MySpaceId/documents?page%5Bsize%5D=10&page%5Bnumber%5D=5 type: string type: object meta: properties: totalCount: format: int32 type: integer type: object type: object jobsSinglePostResponse: properties: data: properties: type: enum: - jobs type: string id: example: MyJobId type: string attributes: properties: jobId: example: example type: string name: example: example type: string state: example: example type: string status: properties: message: example: message type: string type: enum: - OK - CANCELLED - FAILED - UNKNOWN type: string type: object type: object relationships: properties: document: properties: data: properties: id: example: MyProjectId/MySpaceId/MyDocumentId type: string type: enum: - documents type: string type: object type: object documents: properties: data: items: properties: id: example: MyProjectId/MySpaceId/MyDocumentId type: string type: enum: - documents type: string type: object type: array type: object project: properties: data: properties: id: example: MyProjectId type: string type: enum: - projects type: string type: object type: object type: object links: properties: downloads: example: - https://example.com/polarion/download/filename1 - https://example.com/polarion/download/filename2 type: array log: example: server-host-name/application-path/polarion/job-report?jobId=MyJobId type: string self: example: server-host-name/application-path/jobs/MyJobId type: string type: object type: object type: object documentsSingleGetResponse: properties: data: properties: type: enum: - documents type: string id: example: MyProjectId/MySpaceId/MyDocumentId type: string revision: example: '1234' type: string attributes: properties: autoSuspect: type: boolean branchedWithInitializedFields: items: example: fieldId type: string type: array branchedWithQuery: example: Branched with Query type: string created: example: '1970-01-01T00:00:00Z' format: date-time type: string derivedFields: items: example: fieldId type: string type: array derivedFromLinkRole: example: relates_to type: string homePageContent: properties: type: enum: - text/html - text/plain type: string value: example: My text value type: string type: object moduleFolder: example: MySpaceId type: string moduleName: example: MyDocumentId type: string outlineNumbering: properties: prefix: example: ABC type: string type: object renderingLayouts: items: properties: label: example: My label type: string layouter: example: paragraph type: string properties: items: properties: key: example: fieldsAtStart type: string value: example: id type: string type: object type: array type: example: task type: string type: object type: array status: example: draft type: string structureLinkRole: example: relates_to type: string title: example: Title type: string type: example: req_specification type: string updated: example: '1970-01-01T00:00:00Z' format: date-time type: string usesOutlineNumbering: type: boolean type: object relationships: properties: attachments: properties: data: items: properties: id: example: MyProjectId/MySpaceId/MyDocumentId/MyAttachmentId type: string revision: example: '1234' type: string type: enum: - document_attachments type: string type: object type: array links: properties: related: example: server-host-name/application-path/projects/MyProjectId/spaces/MySpaceId/documents/MyDocumentId/attachments?revision=1234 type: string type: object meta: properties: totalCount: format: int32 type: integer type: object type: object author: properties: data: properties: id: example: MyUserId type: string revision: example: '1234' type: string type: enum: - users type: string type: object type: object branchedFrom: properties: data: properties: id: example: MyProjectId/MySpaceId/MyDocumentId type: string revision: example: '1234' type: string type: enum: - documents type: string type: object type: object comments: properties: data: items: properties: id: example: MyProjectId/MySpaceId/MyDocumentId/MyCommentId type: string revision: example: '1234' type: string type: enum: - document_comments type: string type: object type: array links: properties: related: example: server-host-name/application-path/projects/MyProjectId/spaces/MySpaceId/documents/MyDocumentId/comments?revision=1234 type: string type: object meta: properties: totalCount: format: int32 type: integer type: object type: object derivedFrom: properties: data: properties: id: example: MyProjectId/MySpaceId/MyDocumentId type: string revision: example: '1234' type: string type: enum: - documents type: string type: object type: object project: properties: data: properties: id: example: MyProjectId type: string revision: example: '1234' type: string type: enum: - projects type: string type: object type: object updatedBy: properties: data: properties: id: example: MyUserId type: string revision: example: '1234' type: string type: enum: - users type: string type: object type: object variant: 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/spaces/MySpaceId/documents/MyDocumentId?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/spaces/MySpaceId/documents/MyDocumentId?revision=1234 type: string type: object 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 documentsSinglePostResponse: properties: data: properties: type: enum: - documents type: string id: example: MyProjectId/MySpaceId/MyDocumentId type: string attributes: properties: autoSuspect: type: boolean branchedWithInitializedFields: items: example: fieldId type: string type: array branchedWithQuery: example: Branched with Query type: string created: example: '1970-01-01T00:00:00Z' format: date-time type: string derivedFields: items: example: fieldId type: string type: array derivedFromLinkRole: example: relates_to type: string homePageContent: properties: type: enum: - text/html - text/plain type: string value: example: My text value type: string type: object moduleFolder: example: MySpaceId type: string outlineNumbering: properties: prefix: example: ABC type: string type: object renderingLayouts: items: properties: label: example: My label type: string layouter: example: paragraph type: string properties: items: properties: key: example: fieldsAtStart type: string value: example: id type: string type: object type: array type: example: task type: string type: object type: array status: example: draft type: string title: example: Title type: string type: example: req_specification type: string updated: example: '1970-01-01T00:00:00Z' format: date-time type: string usesOutlineNumbering: type: boolean type: object relationships: properties: attachments: properties: data: items: properties: id: example: MyProjectId/MySpaceId/MyDocumentId/MyAttachmentId type: string type: enum: - document_attachments type: string type: object type: array links: properties: related: example: server-host-name/application-path/projects/MyProjectId/spaces/MySpaceId/documents/MyDocumentId/attachments?revision=1234 type: string type: object type: object author: properties: data: properties: id: example: MyUserId type: string type: enum: - users type: string type: object type: object branchedFrom: properties: data: properties: id: example: MyProjectId/MySpaceId/MyDocumentId type: string type: enum: - documents type: string type: object type: object comments: properties: data: items: properties: id: example: MyProjectId/MySpaceId/MyDocumentId/MyCommentId type: string type: enum: - document_comments type: string type: object type: array links: properties: related: example: server-host-name/application-path/projects/MyProjectId/spaces/MySpaceId/documents/MyDocumentId/comments?revision=1234 type: string type: object type: object derivedFrom: properties: data: properties: id: example: MyProjectId/MySpaceId/MyDocumentId type: string type: enum: - documents type: string type: object type: object project: properties: data: properties: id: example: MyProjectId type: string type: enum: - projects type: string type: object type: object updatedBy: properties: data: properties: id: example: MyUserId type: string type: enum: - users type: string type: object type: object variant: properties: data: properties: id: example: MyProjectId/MyWorkItemId type: string type: enum: - workitems type: string type: object type: object type: object links: properties: self: example: server-host-name/application-path/projects/MyProjectId/spaces/MySpaceId/documents/MyDocumentId?revision=1234 type: string type: object type: object type: object documentsListPostResponse: properties: data: items: properties: type: enum: - documents type: string id: example: MyProjectId/MySpaceId/MyDocumentId type: string links: properties: self: example: server-host-name/application-path/projects/MyProjectId/spaces/MySpaceId/documents/MyDocumentId?revision=1234 type: string type: object 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 documentsSinglePatchRequest: properties: data: properties: type: enum: - documents type: string id: example: MyProjectId/MySpaceId/MyDocumentId type: string attributes: properties: autoSuspect: type: boolean homePageContent: properties: type: enum: - text/html - text/plain type: string value: example: My text value type: string type: object outlineNumbering: properties: prefix: example: ABC type: string type: object renderingLayouts: items: properties: label: example: My label type: string layouter: example: paragraph type: string properties: items: properties: key: example: fieldsAtStart type: string value: example: id type: string type: object type: array type: example: task type: string type: object type: array status: example: draft type: string title: example: Title type: string type: example: req_specification type: string usesOutlineNumbering: type: boolean type: object type: object type: object branchDocumentRequestBody: properties: copyWorkflowStatusAndSignatures: description: Specifies that workflow status and signatures should be copied to the branched document. example: false type: boolean query: description: Specifies optional filtering query. example: status:open type: string targetDocumentName: description: Name for new Document. example: MyDocumentId type: string targetProjectId: description: Project where new document will be created. example: MyProjectId type: string targetSpaceId: description: Space where new document will be created. example: MySpaceId type: string type: object copyDocumentRequestBody: properties: linkOriginalItemsWithRole: description: Link a copy of the document to the original. example: duplicates type: string removeOutgoingLinks: description: Should outgoing links be removed? example: true type: boolean targetDocumentName: description: Name for new Document. example: MyDocumentId type: string targetProjectId: description: Project where new document will be created. example: MyProjectId type: string targetSpaceId: description: Space where new document will be created. example: MySpaceId type: string type: object enumOptionsActionResponseBody: properties: data: items: properties: id: example: open type: string color: example: '#F9FF4D' type: string columnWidth: example: 90% type: string createDefect: example: true type: boolean default: example: true type: boolean description: example: Description type: string hidden: example: false type: boolean iconURL: example: /polarion/icons/default/enums/status_open.gif type: string limited: example: true type: boolean minValue: example: 30.0 type: number name: example: Open type: string oppositeName: example: Opposite Name type: string parent: example: true type: boolean requiresSignatureForTestCaseExecution: example: true type: boolean templateWorkItem: example: exampleTemplate type: string terminal: example: true type: boolean type: object type: array links: properties: first: example: server-host-name/application-path/projects/MyProjectId/.../fields/MyField/actions/actionName?page%5Bnumber%5D=1 type: string last: example: server-host-name/application-path/projects/MyProjectId/.../fields/MyField/actions/actionName?page%5Bnumber%5D=9 type: string next: example: server-host-name/application-path/projects/MyProjectId/.../fields/MyField/actions/actionName?page%5Bnumber%5D=6 type: string prev: example: server-host-name/application-path/projects/MyProjectId/.../fields/MyField/actions/actionName?page%5Bnumber%5D=4 type: string self: example: server-host-name/application-path/projects/MyProjectId/.../fields/MyField/actions/actionName?page%5Bsize%5D=10&page%5Bnumber%5D=5 type: string type: object meta: properties: totalCount: format: int32 type: integer type: object type: object securitySchemes: bearerAuth: bearerFormat: JWT scheme: bearer type: http