Sign in

v1

latestOpenAPI 3.0.1Apache 2.02026-07-1310566642.9 KB
Operations

Get a Review by ID

Retrieve the currently stored Review data for the given ID.

The result will be what is currently stored, ignoring any pending updates or deletes.

Only Connect apps that define the jiraOperationsInfoProvider module can access this resource. This resource requires the 'READ' scope for Connect apps.

get/rest/operations/1.0/post-incident-reviews/{reviewId}

Path parameters

reviewIdstring required

The ID of the Review to fetch.

Response

The Review data currently stored for the given ID.

schemaVersion'1.0' required

The PostIncidentReviewData schema version used for this post-incident review data.

Placeholder to support potential schema changes in the future.

idstring required

The identifier for the Review. Must be unique for a given Provider.

updateSequenceNumberinteger required

An ID used to apply an ordering to updates for this Review in the case of out-of-order receipt of update requests.

This can be any monotonically increasing number. A suggested implementation is to use epoch millis from the Provider system, but other alternatives are valid (e.g. a Provider could store a counter against each Review and increment that on each update to Jira).

Updates for a Review that are received with an updateSqeuenceId lower than what is currently stored will be ignored.

reviewsstring[] required

The IDs of the Incidents covered by this Review. Must be unique for a given Provider.

summarystring required

The human-readable summary for the Post-Incident Review. Will be shown in the UI.

If not provided, will use the ID for display.

descriptionstring required

A description of the review in Markdown format. Will be shown in the UI and used when creating Jira Issues.

urlstring uri required

A URL users can use to link to a summary view of this review, if appropriate.

This could be any location that makes sense in the Provider system (e.g. if the summary information comes from a specific project, it might make sense to link the user to the review in that project).

createdDatestring date-time required

The timestamp to present to the user that shows when the Review was raised.

Expected format is an RFC3339 formatted string.

lastUpdatedstring date-time required

The last-updated timestamp to present to the user the last time the Review was updated.

Expected format is an RFC3339 formatted string.

status'in progress' | 'outstanding actions' | 'completed' | 'unknown' required

The current status of the Post-Incident Review.

Example response

{
  "schemaVersion": "1.0",
  "id": "111-222-333",
  "updateSequenceNumber": 1523494301448,
  "reviews": [
    "111-222-333",
    "444-555-666"
  ],
  "summary": "PIR - Unable to log into VPN",
  "url": "https://example.com/project/ITHELPDESK-9/summary",
  "createdDate": "2018-01-20T23:27:25.000Z",
  "lastUpdated": "2018-01-20T23:27:25.000Z",
  "status": "open",
  "associations": [
    {
      "associationType": "issueIdOrKeys",
      "values": [
        "ITSM-123"
      ]
    }
  ]
}