API 1.9

Software version: API 1.9

Scheduled release date:    

This file provides information about the VERA API Server

  • Resolved Issues
  • New Features
  • Docker Image Information
  • Known Issues and Limitations

Version Info

High-level VERA Version2021.3
API Version1.9.0

Software Build

(Can be verified on the "Versions" screen in the web portal.)


Resolved Issues

VS-1134qTest Defects on Test Run showing non-existent Defect when linked to Jira CloudFixed inclusion of defects that exist in an integrated Jira Cloud Server.

XRay executions with long durations get an integer overflow

Fixed issues with long XRay test durations and other potential large values by using 64-bit integer values. 
VS-1256Incorrect JSON schema from XRay prevents routing of XRay testsFixed parsing of XRay Test Executions when the Test contains a text field custom test step field.  This works around an issues in the XRay REST API.

Notifications are not being sent in production systems

Fixed a bug in our approval task notification feature in which certain approval routes would not generate email notifications.  The root cause was an internal issue with the VERA REST API in which approval group names containing spaces could not be queried for members to notify.  Furthermore, the issue was causing the entire notification sequence to abort, thus cancelling notifications for all other groups in the route.

This issue is patched and the email notification feature will work with all supported approval group names.

New Features



  • 1.9.0
  • linux-1.9.0
How to UpgradeSee Upgrade the VERA Server Applications for instructions

Known Issues and Limitations



Known Issue Details

VS-139"Pending Tasks" field refreshes too slowly after route withdrawal.The Pending Tasks field in qTest and Jira is not immediately updated when the record is approved or rejected in VERA.  The cached values are updated when the user invokes a browser refresh,
VS-323VERA Server needs a reboot to fully read new Sync Policy entriesChanges to the VERA Synchronization Policy will not take affect until the VERA Application service is restarted.
VS-447User Administrator role can see Signature Verification Failure Report and Re-verifyA User Administrator can access the Signature Verification reporting section of the Administration Portal.  This feature should be limited to System Administrators.
VS-606Error while sorting approval queue with large quantity of tasksUsers may encounter errors while sorting an approval queue with a large (thousands) quantity of tasks.
VS-668Sorting shows all values beginning with a capital letter before lowercase valuesWhen sorting data (users, records, etc.) alphabetically, the system erroneously alphabetizes capital letters independently from lower-case letters.  For example:  Apple, Cat, ball -- instead of: Apple, ball, Cat
VS-698VERA cannot create a qTest record if two fields in the record have the same nameThe VERA-qTest integration does not support importing records from qTest where the record has two fields with the same name.  If such a record is routed for approval from qTest, then an error will occur.
VS-700User sees duplicate approval tasks for the same record in approval queueIf an approval route contains two pending tasks for the same role (e.g. two Technical approvals) then an eligible approver will see both tasks in their queue.
VS-810Admin can't remove a project from domain if project name contains regexA project created with regex characters cannot be removed from a domain once it is added. This also causes issues with displaying tasks in the approval queue for a user
VS-962Approval Queue user filter uses RegEx can match different usersDue to regular expression matching, a record that has been signed by one user may cause another user's approval queue to exclude the record when it should be available.
VS-988VERA DevOps does not apply a default approval routeIf a record is routed for approval that does not satisfy any configured route templates, the user will see "VERA is trying to start the approval route" rather than a descriptive error containing the reason why the route was not started.
VS-1060If user has a null value for a role in their claims list the user module fails to add or remove them from a roleIf a user has a claim that has a type of role and a value of null (not just a blank string), the user module will throw an exception when trying to add or remove the user from a role.
VS-1065A misleading error message is displayed when VERA cannot apply a final approvalVERA will display a misleading error message when it fails to transition a Jira issue in the workflow.  The error message displayed to the user will indicate that there is a connectivity problem, even if it's actually a configuration problem. 
VS-1095Project names are not validated when adding to domainAdmins are able to add a project to a domain that contains RegEx characters.
VS-1142Special character in group name is preventing the role membership table from displaying usersThe special character in group name is preventing the role membership table from displaying users.   You can still manage the group with the special character in the name # You can still add users to the role on the Role Management screen.

Invalid Approval Group error log should indicate with group or line number the error is on

Currently error log does not display approval group details when invalid approval group is logged. 
VS-1262Routing Test Execution for Approval fails if test has Xray custom test step fieldsWhen routing a Test Execution if will fail if test has any of these custom test step fields. 
  • Toogle
  • Date Picker
  • Date Time Picker
  • Number
  • Radio Buttons
  • Select List (muliple choices)
  • Select List (single choice)

VERA does not properly handle a hidden Sync ID field in Jira

VERA does not have valid error handling for scenarios in which the VERA Sync ID field in Jira is inaccessible (e.g.. not on the issue's edit screen).
VS-1264VERA does not recognize duplicate webhook requests from Jira Cloud

VERA does not detect when it receives a retried webhook from Jira Cloud and whether that webhook has already been processed.

VERA should be able to recognize whether a given webhook request is a duplicate (retry) and whether it has already been processed.  That is, VERA should only process new webhook requests or retried webhook requests where the original requests were missed.  Otherwise, this can cause the two systems to become too far out-of-sync.


VERA returns an HTTP 500 status code to Jira webhooks when it cannot access the Sync ID field

With Jira Cloud, the HTTP 500 status code will prompt Jira to retry the same webhook a few minutes later.  This is undesirable, because a) there is no reasonable expectation that it will succeed, and b) the user will have very likely tried rerouting the record again anyway.

Therefore, the Jira module should return a different status code that will not trigger a retry from Jira Cloud.


VERA does not handle concurrent start route requests for the same record

The VERA API does not have proper handling for concurrent start approval route requests for the same record.  If it is a new record, then the end result could be the record receiving two different Sync IDs each with its own approval route.

VERA does not clean-up routes on Start Route, Revise, Approve, etc.

The VERA/Jira API will proactively clean-up the routes associated with a record by cancelling all routes when one of them is cancelled.  This clean-up should occur on other triggers as well, because there should never be more than one "active" route for a record at a time. 
VS-1293Final approval fails when Jira projects are configured with a Signatures fieldVERA will attempt to write the entire approval route to the Jira Signatures field if the field is present in the Jira project. If the approval route contains over 255 characters the Approval will fail since VERA is attempting to write over 255 characters to the field.