Endpoints:
GET /rest/secure-fields/1.0/history?issueKey={issueKey}
GET /rest/secure-fields/1.0/history?issueKey={issueKey}&secureFieldId=customfield_{secureFieldId}
where issueKey is the key of the issue and secureFieldId is the id of Secure Field.
The first endpoint returns the whole history of the Secure Fields for the given issue and the second one returns history for a specific Secure Field.
Response Structure:
[
{
"created":number,
"author":number,
"authorFullName":text,
"issueId":number,
"secureFieldChangeItems":[
{
"oldValue":text,
"newValue":text,
"secureFieldId":number,
"secureFieldName":text
}
]
}
]
created | Secure Field creation date |
author | author’s key |
authorFullName | author’s full name |
issueId | issue id |
oldValue | previous value of Secure Field |
newValue | new value of Secure Field |
secureFieldId | Secure Field id |
secureFieldName | Secure Field name |
If successful, the response status is OK HTTP 200.
If no Issue corresponding to provided issueKey was found, the endpoint returns BAD REQUEST 400 with message Issue for key {id} not found.
If no Custom Field corresponding to provided secureFieldId was found, the endpoint returns BAD REQUEST 400 with message Custom field for id {id} not found.
If the type of Custom Field corresponding to provided secureFieldId was not Secure Field, the endpoint returns BAD REQUEST 400 with the message The given custom field is not a Secure Field.
If a user has no permission for this Secure field, the endpoint returns FORBIDDEN 403 with the message User {user} has no permission to view history in field {id}.
Example of Secure Field History data returned from REST API:
[
{
"created":1617950735988,
"author":"JIRAUSER10000",
"authorFullName":"admin.admin",
"issueId":10100,
"secureFieldChangeItems":[
{
"oldValue":"2, 3",
"newValue":"2, 3, 5",
"secureFieldId":10100,
"secureFieldName":"Secure List"
}
]
},
{
"created":1617950755314,
"author":"JIRAUSER10010",
"authorFullName":"John Smith",
"issueId":10100,
"secureFieldChangeItems":[
{
"oldValue":"old Test",
"newValue":"new Test",
"secureFieldId":10001,
"secureFieldName":"Secure Text"
}
]
}
]