v56

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014121451.1 MB

Security Penetration Tests

Add context to a pentest finding

Saves a customer context note on a pentest finding, e.g. an accepted-by-design rationale or remediation details. Future scans of the same target pass the note to the testing agent so the issue is retested with that context.

put/v1/pentest-finding-contexts/{issueId}

Path parameters

issueIdstring required

Headers

X-Organization-Idstring

Organization ID (required for session auth, optional for API key auth)

Request body

runIdstring required

Penetration test run ID the finding belongs to

contextstring required

Context for the finding, e.g. an accepted-by-design rationale or remediation details. Shared with the testing agent on future scans of the same target. Max 2000 characters.

Example request

{
  "runId": "pentest-abc123",
  "context": "Read access to appConfiguration is accepted by design: the collection only holds non-secret bootstrap configuration and write access is restricted to privileged users."
}

Response

Context note saved