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/components/schemas/revision_model.yml

102 lines
2.6 KiB

# Schema: RevisionModel
---
type: object
required:
- identifier
- formattedIdentifier
- authorName
- message
- createdAt
properties:
id:
type: integer
description: Revision's id, assigned by OpenProject
readOnly: true
minimum: 0
exclusiveMinimum: true
identifier:
type: string
description: The raw SCM identifier of the revision (e.g. full SHA hash)
readOnly: true
formattedIdentifier:
type: string
description: The SCM identifier of the revision, formatted (e.g. shortened unambiguous
SHA hash). May be identical to identifier in many cases
readOnly: true
authorName:
type: string
description: The name of the author that committed this revision. Note that this
name is retrieved from the repository and does not identify a user in OpenProject.
readOnly: true
message:
allOf:
- "$ref": "./formattable.yml"
- description: The commit message of the revision
readOnly: true
createdAt:
type: string
format: date-time
description: The time this revision was committed to the repository
_links:
type: object
required:
- self
- project
- showRevision
properties:
self:
allOf:
- "$ref": "./link.yml"
- description: |-
This revision
**Resource**: Revision
readOnly: true
project:
allOf:
- "$ref": "./link.yml"
- description: |-
The project to which the revision belongs
**Resource**: Project
readOnly: true
author:
allOf:
- "$ref": "./link.yml"
- description: |-
The user that added this revision, if the authorName was mapped to a user in OpenProject
**Resource**: User
readOnly: true
showRevision:
allOf:
- "$ref": "./link.yml"
- description: |-
A URL to the repository view (outside APIv3) showing this revision
**Resource**: -
readOnly: true
example:
_type: Revision
_links:
self:
href: "/api/v3/revisions/1"
project:
href: "/api/v3/projects/1"
author:
href: "/api/v3/users/1"
showRevision:
href: "/projects/identifier/repository/revision/11f4b07"
id: 1
identifier: 11f4b07dff4f4ce9548a52b7d002daca7cd63ec6
formattedIdentifier: 11f4b07
authorName: Some Developer
message:
format: plain
raw: |-
This revision provides new features
An elaborate description
html: "<p>This revision provides new features<br/><br/>An elaborate description</p>"
createdAt: '2015-07-21T13:36:59Z'