Skip to main content

Annotations REST API

You can use the Annotations API to annotate findings, including adding comments and proposing, accepting, and rejecting mitigations. This API applies to findings from a Static Analysis or Dynamic Analysis.

Permissions​

Before you can use all endpoints of this API, you must have one of the following accounts with the required roles:

  • A UI user account with the following roles:

    • Reviewer or Security Lead: to add comments or propose mitigations.
    • Mitigation Approver: to approve or reject mitigation proposals.
  • An API user account with the following roles:

    • Results API: to add comments or propose mitigations.
    • Mitigation API: to approve or reject mitigation proposals.

Authentication​

This API requires secure authentication to Veracode.

Annotations API specification​

The Annotations API specification is available from SwaggerHub.