v56

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

Security Penetration Tests

Create penetration test

Create an AI-powered penetration test run for an approved target and track the resulting findings and report artifacts.

post/v1/security-penetration-tests

Headers

X-Organization-Idstring

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

Request body

targetUrlstring required

Target URL for the penetration test scan

repoUrlstring

Repository URL containing the target application code

additionalContextstring

Free-text context shared with the testing agent, e.g. remediation notes or accepted-by-design explanations from a previous run. Saved per-finding context notes for the same target are appended automatically. Max 4000 characters.

Example request

{
  "targetUrl": "https://app.example.com",
  "repoUrl": "https://github.com/org/repo"
}

Response

Penetration test created