Skip to navigation
API ReferenceIssues

Retest an issue

Queues an asynchronous retest against the issue’s original target. Subscribe to the retest.completed webhook for the verdict, or poll List issue retests. After a retest fails with failureCode: "target-scope", send targetRetry to retry once against a replacement target; the original target is unchanged and history records both.

Requires the issues:write API key scope.

Authentication

AuthorizationBearer

A workspace API key, sent as Authorization: Bearer.

OR
x-api-keystring

A workspace API key, sent as x-api-key.

Path parameters

issueIdstringRequired

Issue UUID or label, e.g. VULN-000123.

Request

This endpoint expects an object.
targetRetryobjectOptional

Only after a retest failed with failureCode: "target-scope": a replacement target for one retry. domainId must be a verified domain in this workspace and targetUrl must be on its exact origin.

Response

The retest was queued.
sessionIdstringformat: "uuid"
issueIdstringformat: "uuid"
statusenum
Allowed values:
messagestring

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error