OpenProject is the leading open source project management software.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
openproject/docs/api/apiv3/paths/work_package_revisions.yml

118 lines
4.3 KiB

# /api/v3/work_packages/{id}/revisions
---
get:
parameters:
- description: Work package id
example: '1'
in: path
name: id
required: true
schema:
type: integer
responses:
'200':
content:
application/hal+json:
examples:
response:
value:
_embedded:
elements:
- _links:
author:
href: "/api/v3/users/1"
title: John Sheppard - j.sheppard
project:
href: "/api/v3/projects/1"
title: A Test Project
self:
href: "/api/v3/revisions/13"
showRevision:
href: "/projects/identifier/repository/revision/11f4b07"
_type: Revision
authorName: John Sheppard
createdAt: '2015-07-21T13:36:59Z'
formattedIdentifier: 11f4b07
id: 13
identifier: 11f4b07dff4f4ce9548a52b7d002daca7cd63ec6
message:
format: plain
html: "<p>This revision provides new features<br/><br/>An elaborate
description</p>"
raw: |-
This revision provides new features
An elaborate description
- _links:
author:
href: "/api/v3/users/2"
title: Jim Sheppard - j.sheppard
project:
href: "/api/v3/projects/1"
title: A Test Project
self:
href: "/api/v3/revisions/14"
showRevision:
href: "/projects/identifier/repository/revision/029ed72a"
_type: Revision
authorName: j1msheppard
createdAt: '2015-06-30T08:47:00Z'
formattedIdentifier: '029ed72a'
id: 13
identifier: '029ed72a3b7b7c4ab332b1f6eaa6576e7c946059'
message:
format: plain
html: "<p>This revision fixes some stuff<br/><br/>More information
here</p>"
raw: |-
This revision fixes some stuff
More information here
_links:
self:
href: "/api/v3/work_packages/42/revisions"
_type: Collection
count: 2
total: 2
schema:
"$ref": "../components/schemas/revisions_model.yml"
description: OK
headers: {}
'403':
content:
application/hal+json:
examples:
response:
value:
_type: Error
errorIdentifier: urn:openproject-org:api:v3:errors:MissingPermission
message: You are not allowed to see linked revisions for this work
package.
description: |-
Returned if the client does not have sufficient permissions.
**Required permission:** view work packages for the project the work package is contained in.
*Note that you will only receive this error, if you are at least allowed to see the corresponding work package.*
headers: {}
'404':
content:
application/hal+json:
examples:
response:
value:
_type: Error
errorIdentifier: urn:openproject-org:api:v3:errors:NotFound
message: The specified work project does not exist.
description: |-
Returned if the work package does not exist or the client does not have sufficient permissions to see it.
**Required permission:** view work package
headers: {}
tags:
- Work Packages
description: |-
Gets a list of revisions that are linked to this work package, e.g., because it is referenced in the commit message of the revision.
Only linked revisions from repositories are shown if the user has the view changesets permission in the defining project.
operationId: Revisions
summary: Revisions