For the complete documentation index, see llms.txt. This page is also available as Markdown.

Fetch Data

API
Description

POST /api/fetchTestRunResultsCount

Fetch the count of scan results, useful for pagination or summaries.

POST /api/fetchSeverityInfoForIssues

Retrieve aggregated severity information (Critical, High, Medium, Low) for issues.

POST /api/fetchIssueFromTestRunResultDetails

Get detailed issue information from a specific scan result.

POST /api/fetchAllSubCategories

Fetch all issue subcategories (e.g., SQLi, XSS under Injection) used for classification.

POST /api/fetchRemediationInfo

Retrieve remediation details and best practices for fixing a specific issue.

POST /api/fetchTestRunResultDetails

Get detailed information about a specific scan result.

POST /api/findTotalIssuesByDay

Fetch the total number of issues discovered per day, useful for trend analysis.

POST /api/fetchAllIssues

Retrieve all issues detected across agentic collections and scan runs.

POST /api/fetchTestingRunResultSummaries

Fetch summaries of scan results (high-level overview of findings).

POST /api/generateReportPDF

Generate a downloadable PDF report of scan results and issues.

POST /api/fetchTestingRunResults

Fetch detailed scan results including all issues found.

POST /api/fetchActiveTestRunsStatus

Retrieve the current status of active scan runs.

POST /api/fetchTestResultsStatsCount

Get statistical counts of scan results grouped by categories (e.g., pass/fail).

POST /api/fetchTestingRunResult

Fetch a single scan result with its details.

POST /api/fetchVulnerableTestingRunResultsFromIssues

Retrieve scan results linked to vulnerable issues.

POST /api/getAllTestsCountMap

Get a count map of all available probes grouped by categories/subcategories.

POST /api/retrieveAllCollectionTests

Retrieve all probes mapped to agentic collections.

POST /api/fetchTestingRunResultsSummary

Fetch a summary of scan results, highlighting major findings.

POST /api/fetchIssuesByApis

Get all issues grouped by Agentic Components for better component-level visibility.

POST /api/fetchIssuesFromResultIds

Fetch issues associated with specific scan result IDs.

POST /api/fetchCriticalIssuesTrend

Retrieve the trend of critical issues over time.

POST /api/fetchTestCoverageData

Fetch scan coverage data showing which agentic components have been scanned and which remain unscanned.

POST /api/fetchCategoryWiseScores

Get probe scores grouped by probe category (OWASP, CWE, etc.).

POST /api/fetchVulnerableTestRunResults

Get scan results that found vulnerabilities.

POST /api/fetchAffectedEndpoints

Retrieve Agentic components affected by specific issues or vulnerabilities.

POST /api/fetchSensitiveSampleData

Fetch sample data containing sensitive information from scan results.

POST /api/fetchSubTypeCountMap

Get a count map of issue subtypes from scan results.

POST /api/getIssueSummaryInfo

Fetches a summary of issues including counts by severity and category.

POST /api/getIssuesTrend

Retrieves the trend of issues over time for analysis and reporting.

POST /api/findTotalIssues

Finds the total count of issues matching specified filters.

POST /api/fetchIssuesData

Fetches detailed data for issues including metadata and context.

POST /api/fetchUrlsByIssues

Retrieves the Agentic components associated with specific issues.

POST /api/getReportFilters

Fetches available filter options for generating reports.

POST /api/downloadReportPDF

Downloads a PDF report of scan results and issues.

POST /api/getThreatReportFilters

Fetches available filter options for threat reports.

POST /api/downloadThreatReportPDF

Downloads a PDF threat report based on current filters.

POST /api/downloadSamplePdf

Downloads a sample PDF report for preview or reference.

POST /api/fetchConversationsFromConversationId

Fetches conversation history associated with a specific conversation ID.

POST request for endpoint /api/fetchTestRunResultsCount

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

testingRunHexIdstringOptionalExample: 6464783658e3a17b14ddfa67
filterTestNamestringOptionalExample: null
filterSeveritystring[]Optional
filterStatusstring[]Optional
Responses
200

description

application/json

Sample description

totalinteger · int32OptionalExample: 100
byStatusobjectOptionalExample: {"PASSED":80,"FAILED":20}
bySeverityobjectOptionalExample: {"CRITICAL":5,"HIGH":10,"MEDIUM":20,"LOW":65}
post/api/fetchTestRunResultsCount
200

description

POST request for endpoint /api/fetchSeverityInfoForIssues

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

testingRunHexIdstringOptionalExample: 6464783658e3a17b14ddfa67
Responses
200

description

application/json

Sample description

severityInfoobjectOptionalExample: {"CRITICAL":5,"HIGH":12,"MEDIUM":23,"LOW":45}
post/api/fetchSeverityInfoForIssues
200

description

POST request for endpoint /api/fetchIssueFromTestRunResultDetails

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

testingRunResultHexIdstringOptionalExample: 6464783658e3a17b14ddfa67
Responses
200

description

application/json

Sample description

metadatastringOptionalExample: null
testingRunResultsstringOptionalExample: null
testingRunResultSummariesstringOptionalExample: null
selectedTestsstringOptionalExample: null
maxConcurrentRequestsinteger · int32OptionalExample: 0
testingRunsstringOptionalExample: null
recurringDailybooleanOptionalExample: false
workflowTeststringOptionalExample: null
authMechanismstringOptionalExample: null
testingRunResultstringOptionalExample: null
fetchCicdbooleanOptionalExample: false
testingRunstringOptionalExample: null
testRunTimeinteger · int32OptionalExample: 0
testingRunHexIdstringOptionalExample: null
endTimestampinteger · int32OptionalExample: 0
startTimestampinteger · int32OptionalExample: 0
testNamestringOptionalExample: null
post/api/fetchIssueFromTestRunResultDetails
200

description

POST request for endpoint /api/fetchAllSubCategories

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body
objectOptional

Sample description

Responses
200

description

application/json
objectOptional

AKTO_ERROR while building schema

post/api/fetchAllSubCategories
200

description

POST request for endpoint /api/fetchRemediationInfo

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

issueIdstringOptionalExample: null
Responses
200

description

application/json

Sample description

remediationInfostringOptionalExample: null
remediationCodestringOptionalExample: null
post/api/fetchRemediationInfo
200

description

POST request for endpoint /api/fetchTestRunResultDetails

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

testingRunResultHexIdstringOptionalExample: 6464783658e3a17b14ddfa67
Responses
200

description

application/json

Sample description

metadatastringOptionalExample: null
testingRunResultsstringOptionalExample: null
testingRunResultSummariesstringOptionalExample: null
runIssuesstringOptionalExample: null
selectedTestsstringOptionalExample: null
maxConcurrentRequestsinteger · int32OptionalExample: 0
testingRunsstringOptionalExample: null
recurringDailybooleanOptionalExample: false
workflowTeststringOptionalExample: null
authMechanismstringOptionalExample: null
fetchCicdbooleanOptionalExample: false
testingRunstringOptionalExample: null
testRunTimeinteger · int32OptionalExample: 0
testingRunHexIdstringOptionalExample: null
endTimestampinteger · int32OptionalExample: 0
startTimestampinteger · int32OptionalExample: 0
testNamestringOptionalExample: null
post/api/fetchTestRunResultDetails
200

description

POST request for endpoint /api/findTotalIssuesByDay

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

startTimestampinteger · int32OptionalExample: 1712000000
endTimestampinteger · int32OptionalExample: 1712100000
Responses
200

description

application/json

Sample description

post/api/findTotalIssuesByDay
200

description

POST request for endpoint /api/fetchAllIssues

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

limitinteger · int32OptionalExample: 20
filterStatusstring[]OptionalExample: OPEN
skipinteger · int32OptionalExample: 0
startEpochinteger · int32OptionalExample: 0
Responses
200

description

application/json

Sample description

vulnerableRequestsstringOptionalExample: null
issueIdstringOptionalExample: null
similarlyAffectedIssuesstringOptionalExample: null
filterStatusstring[]OptionalExample: OPEN
skipinteger · int32OptionalExample: 0
startEpochinteger · int32OptionalExample: 0
issueIdArraystringOptionalExample: null
testSourceConfigsstringOptionalExample: null
subCategoriesstringOptionalExample: null
totalIssuesCountinteger · int32OptionalExample: 299
testingRunResultstringOptionalExample: null
ignoreReasonstringOptionalExample: null
limitinteger · int32OptionalExample: 20
categoriesstringOptionalExample: null
statusToBeUpdatedstringOptionalExample: null
post/api/fetchAllIssues
200

description

POST request for endpoint /api/fetchTestingRunResultSummaries

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

testingRunHexIdstringOptionalExample: 646477d11cf07b51403bf5b1
endTimestampinteger · int32OptionalExample: 1684477795
startTimestampinteger · int32OptionalExample: 1683901795
Responses
200

description

application/json

Sample description

metadatastringOptionalExample: null
testingRunResultsstringOptionalExample: null
runIssuesstringOptionalExample: null
selectedTestsstringOptionalExample: null
maxConcurrentRequestsinteger · int32OptionalExample: 0
testingRunsstringOptionalExample: null
recurringDailybooleanOptionalExample: false
workflowTeststringOptionalExample: null
authMechanismstringOptionalExample: null
testingRunResultstringOptionalExample: null
fetchCicdbooleanOptionalExample: false
testRunTimeinteger · int32OptionalExample: 0
testingRunHexIdstringOptionalExample: 646477d11cf07b51403bf5b1
endTimestampinteger · int32OptionalExample: 1684477795
startTimestampinteger · int32OptionalExample: 1683901795
testNamestringOptionalExample: null
post/api/fetchTestingRunResultSummaries
200

description

POST request for endpoint /api/generateReportPDF

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

testingRunHexIdstringOptionalExample: 6464783658e3a17b14ddfa67
Responses
200

description

application/json

Sample description

reportUrlstringOptionalExample: null
post/api/generateReportPDF
200

description

POST request for endpoint /api/fetchTestingRunResults

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

testingRunResultSummaryHexIdstringOptionalExample: 6464783058e3a17b14ddf64e
Responses
200

description

application/json

Sample description

metadatastringOptionalExample: null
testingRunResultSummariesstringOptionalExample: null
runIssuesstringOptionalExample: null
selectedTestsstringOptionalExample: null
maxConcurrentRequestsinteger · int32OptionalExample: 0
testingRunsstringOptionalExample: null
recurringDailybooleanOptionalExample: false
workflowTeststringOptionalExample: null
authMechanismstringOptionalExample: null
testingRunResultstringOptionalExample: null
fetchCicdbooleanOptionalExample: false
testingRunstringOptionalExample: null
testRunTimeinteger · int32OptionalExample: 0
testingRunHexIdstringOptionalExample: null
endTimestampinteger · int32OptionalExample: 0
startTimestampinteger · int32OptionalExample: 0
testNamestringOptionalExample: null
post/api/fetchTestingRunResults
200

description

POST request for endpoint /api/fetchActiveTestRunsStatus

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body
objectOptional

Sample description

Responses
200

description

application/json

Sample description

post/api/fetchActiveTestRunsStatus
200

description

POST request for endpoint /api/fetchTestResultsStatsCount

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

testingRunHexIdstringOptionalExample: 6464783658e3a17b14ddfa67
Responses
200

description

application/json

Sample description

post/api/fetchTestResultsStatsCount
200

description

POST request for endpoint /api/fetchTestingRunResult

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

testingRunResultHexIdstringOptionalExample: 6464783658e3a17b14ddfa67
Responses
200

description

application/json

Sample description

testingRunResultobjectOptional
testingRunResultSummaryobjectOptional
post/api/fetchTestingRunResult
200

description

POST request for endpoint /api/fetchVulnerableTestingRunResultsFromIssues

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

testingRunHexIdstringOptionalExample: 6464783658e3a17b14ddfa67
skipinteger · int32OptionalExample: 0
limitinteger · int32OptionalExample: 20
Responses
200

description

application/json

Sample description

post/api/fetchVulnerableTestingRunResultsFromIssues
200

description

POST request for endpoint /api/getAllTestsCountMap

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body
objectOptional

Sample description

Responses
200

description

application/json

Sample description

testsCountMapobjectOptional
post/api/getAllTestsCountMap
200

description

POST request for endpoint /api/retrieveAllCollectionTests

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

fetchCicdbooleanOptionalExample: false
Responses
200

description

application/json

Sample description

metadatastringOptionalExample: null
testingRunResultsstringOptionalExample: null
testingRunResultSummariesstringOptionalExample: null
runIssuesstringOptionalExample: null
selectedTestsstringOptionalExample: null
maxConcurrentRequestsinteger · int32OptionalExample: 0
recurringDailybooleanOptionalExample: false
workflowTeststringOptionalExample: null
testingRunResultstringOptionalExample: null
fetchCicdbooleanOptionalExample: false
testingRunstringOptionalExample: null
testRunTimeinteger · int32OptionalExample: 0
testingRunHexIdstringOptionalExample: null
endTimestampinteger · int32OptionalExample: 1684564190
startTimestampinteger · int32OptionalExample: 1684477790
testNamestringOptionalExample: null
post/api/retrieveAllCollectionTests
200

description

POST request for endpoint /api/fetchTestingRunResultsSummary

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

testingRunHexIdstringOptionalExample: 6464783658e3a17b14ddfa67
Responses
200

description

application/json

Sample description

testingRunResultSummaryobjectOptional
post/api/fetchTestingRunResultsSummary
200

description

POST request for endpoint /api/fetchIssuesByApis

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

apiCollectionIdinteger · int32OptionalExample: 1
skipinteger · int32OptionalExample: 0
limitinteger · int32OptionalExample: 20
Responses
200

description

application/json

Sample description

issuesobject[]Optional
totalinteger · int32OptionalExample: 0
post/api/fetchIssuesByApis
200

description

POST request for endpoint /api/fetchIssuesFromResultIds

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

testingRunResultHexIdsstring[]Optional
Responses
200

description

application/json

Sample description

issuesobject[]Optional
post/api/fetchIssuesFromResultIds
200

description

POST request for endpoint /api/fetchCriticalIssuesTrend

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

startTimestampinteger · int32OptionalExample: 1712000000
endTimestampinteger · int32OptionalExample: 1712100000
Responses
200

description

application/json

Sample description

post/api/fetchCriticalIssuesTrend
200

description

POST request for endpoint /api/fetchTestCoverageData

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

apiCollectionIdinteger · int32OptionalExample: 1
Responses
200

description

application/json

Sample description

coverageDataobjectOptional
testedCountinteger · int32OptionalExample: 0
untestedCountinteger · int32OptionalExample: 0
post/api/fetchTestCoverageData
200

description

POST request for endpoint /api/fetchCategoryWiseScores

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

testingRunHexIdstringOptionalExample: 6464783658e3a17b14ddfa67
Responses
200

description

application/json

Sample description

post/api/fetchCategoryWiseScores
200

description

POST request for endpoint /api/fetchVulnerableTestRunResults

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

testingRunHexIdstringOptionalExample: 6464783658e3a17b14ddfa67
skipinteger · int32OptionalExample: 0
limitinteger · int32OptionalExample: 20
Responses
200

description

application/json

Sample description

post/api/fetchVulnerableTestRunResults
200

description

POST request for endpoint /api/fetchAffectedEndpoints

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

Responses
200

description

application/json

Sample description

filterSubCategorystringOptionalExample: null
vulnerableRequestsstringOptionalExample: null
filterCollectionsIdstringOptionalExample: null
filterStatusstringOptionalExample: null
skipinteger · int32OptionalExample: 0
filterSeveritystringOptionalExample: null
startEpochinteger · int32OptionalExample: 0
issueIdArraystringOptionalExample: null
testSourceConfigsstringOptionalExample: null
issuesstringOptionalExample: null
subCategoriesstringOptionalExample: null
totalIssuesCountinteger · int32OptionalExample: 0
testingRunResultstringOptionalExample: null
ignoreReasonstringOptionalExample: null
limitinteger · int32OptionalExample: 0
categoriesstringOptionalExample: null
statusToBeUpdatedstringOptionalExample: null
post/api/fetchAffectedEndpoints
200

description

POST request for endpoint /api/fetchSensitiveSampleData

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

methodstringOptionalExample: POST
apiCollectionIdinteger · int32OptionalExample: 1684477780
urlstringOptionalExample: /api/fetchQuickStartPageState
Responses
200

description

application/json

Sample description

sensitiveSampleDatastringOptionalExample: {}
sampleDataListstringOptionalExample: null
trafficstringOptionalExample: {}
post/api/fetchSensitiveSampleData
200

description

POST request for endpoint /api/fetchSubTypeCountMap

post
Header parameters
content-typestringOptionalExample: application/json
X-API-KEYstringOptionalExample: YOUR_API_KEY from Settings > Integrations > Akto APIs
Body

Sample description

endTimestampinteger · int32OptionalExample: 1684478055
startTimestampinteger · int32OptionalExample: 0
Responses
200

description

application/json

Sample description

listOfEndpointsInCollectionstringOptionalExample: null
endpointsstringOptionalExample: null
methodstringOptionalExample: null
skipinteger · int32OptionalExample: 0
apiCollectionIdinteger · int32OptionalExample: -1
filtersstringOptionalExample: null
urlstringOptionalExample: null
filterOperatorsstringOptionalExample: null
urlsstringOptionalExample: null
sortKeystringOptionalExample: null
sortOrderinteger · int32OptionalExample: 0
limitinteger · int32OptionalExample: 0
post/api/fetchSubTypeCountMap
200

description

Get issue summary info

post

Returns a map of test sub-category names to their total issue counts within an optional time range and optional collection filter. Used by the dashboard summary widget.

Source: StartTestAction.getIssueSummaryInfo()

Body
startTimestampintegerOptional

Start of the time window (epoch seconds). Defaults to 0 (all time).

Example: 1745000000
endTimestampintegerOptional

End of the time window (epoch seconds). Defaults to Context.now() when 0.

Example: 1745600000
issueSummaryFilterCollectionIdsinteger[]Optional

Optional list of API collection IDs to restrict the summary to.

Example: [1000000,1664578207]
Responses
200

Map of sub-category IDs to issue counts.

application/json
actionErrorsstring[]Optional
post/api/getIssueSummaryInfo
200

Map of sub-category IDs to issue counts.

Get issues trend over time

post

Returns a day-keyed map of issue counts grouped by test sub-category for a given time range. Used to render the trend chart on the Issues dashboard.

Source: DashboardAction.fetchIssuesTrend()

Body
startTimeStampintegerOptional

Start of the trend window (epoch seconds).

Example: 1745000000
endTimeStampintegerOptional

End of the trend window (epoch seconds). Defaults to Context.now() when 0.

Example: 1745600000
Responses
200

Map of day-epoch integers to lists of sub-category trend objects.

application/json
actionErrorsstring[]Optional
post/api/getIssuesTrend
200

Map of day-epoch integers to lists of sub-category trend objects.

Find total issues count

post

Returns two counts for the dashboard summary tile:

  • totalIssuesCount: number of OPEN issues created on or before endTimeStamp (excluding deactivated collections).

  • oldOpenCount: number of OPEN+FIXED issues created on or before startTimeStamp (used as the baseline for the period delta).

Source: DashboardAction.findTotalIssues()

Body
startTimeStampintegerOptional

Baseline epoch for oldOpenCount. Defaults to now - 24 h when 0.

Example: 1745000000
endTimeStampintegerOptional

Upper bound epoch for totalIssuesCount.

Example: 1745600000
Responses
200

Total and baseline issue counts.

application/json
totalIssuesCountinteger · int64Optional

Number of OPEN issues created on or before endTimeStamp, excluding deactivated collections.

Example: 186
oldOpenCountinteger · int64Optional

Number of OPEN+FIXED issues created on or before startTimeStamp, used to compute the delta for the period.

Example: 172
actionErrorsstring[]Optional
post/api/findTotalIssues
200

Total and baseline issue counts.

Fetch consolidated issues analytics data

post

Consolidated API that returns multiple issues analytics datasets in a single response: issues over time, issues by severity, average issue age per severity, open vs. resolved issues over time, top issues by category, top hostnames by critical/high issues, and compliance-at-risk percentages. Intended for the agentic/consolidated dashboard view.

Source: AgenticDashboardAction.fetchIssuesData()

Body
startTimestampintegerOptional

Start of the analytics window (epoch seconds). Pass 0 for all-time.

Example: 1745000000
endTimestampintegerOptional

End of the analytics window (epoch seconds). Defaults to Context.now() when 0.

Example: 1745600000
Responses
200

Consolidated issues analytics.

application/json
actionErrorsstring[]Optional
post/api/fetchIssuesData
200

Consolidated issues analytics.

Fetch URLs grouped by test sub-category

post

Aggregates OPEN issues from testing_run_issues and groups unique URL+method pairs by test sub-category. Only groups with more than one distinct URL+method pair are included (threshold = 1).

  • When showTestSubCategories is false: returns only totalCount (number of qualifying sub-categories).

  • When showTestSubCategories is true: returns testSubCategories (full list) and totalCount.

Source: IssuesAction.fetchUrlsByIssues()

Body
showTestSubCategoriesbooleanOptional

When true, include the full sub-category list in the response. When false, return only the count.

Example: true
Responses
200

Sub-category URL aggregation.

application/json
actionErrorsstring[]Optional
post/api/fetchUrlsByIssues
200

Sub-category URL aggregation.

Get test report filters

post

Retrieves the filter configuration and issue IDs that were stored when the report was generated via generateTestReport. The generatedReportId is the ObjectId hex string returned by that endpoint.

Source: IssuesAction.getReportFilters()

Body
generatedReportIdstringRequired

ObjectId hex string of the test report document (returned by generateTestReport).

Example: 696f83245ae7e4166f7347ad
Responses
200

Report filter configuration.

application/json
actionErrorsstring[]Optional
post/api/getReportFilters

Download test report as PDF

post

Generates or polls for a PDF rendering of a previously created test report (via generateTestReport). On the first call set firstPollRequest: true; subsequent polling calls set it to false and pass back the reportId returned in the previous response. Returns the PDF as a base64-encoded string when status is COMPLETED.

Source: ReportAction.downloadReportPDF()

Body
reportIdstringOptional

ObjectId hex string of the report document. On the first call this is the ID returned by generateTestReport. On subsequent polling calls it is the reportId returned in the previous response.

Example: 696f83245ae7e4166f7347ad
organizationNamestringOptional

Organisation name to embed in the PDF header.

Example: Acme Corp
reportDatestringOptional

Human-readable date string to embed in the PDF.

Example: 2026-04-22
reportUrlstringOptional

URL at which the report is hosted (rendered by the headless browser).

Example: https://app.example.com/dashboard/reports/696f83245ae7e4166f7347ad
usernamestringOptional

Username of the requester to embed in the PDF.

Example: admin@example.com
firstPollRequestbooleanOptional

Set to true on the initial trigger call; false on all subsequent polling calls.

Example: true
Responses
200

PDF generation status and, when complete, the base64-encoded PDF.

application/json
pdfstringOptional

Base64-encoded PDF content. Non-null only when status is COMPLETED.

Example: [REDACTED_BASE64_PDF]
statusstring · enumOptional

Current generation status.

Example: COMPLETEDPossible values:
reportIdstringOptional

Report document ObjectId hex string. Use this as reportId in subsequent polling calls.

Example: 696f83245ae7e4166f7347ad
actionErrorsstring[]Optional
post/api/downloadReportPDF
200

PDF generation status and, when complete, the base64-encoded PDF.

Get threat report filters

post

Retrieves the filter configuration and threat IDs that were stored when the report was generated via generateThreatReport.

Source: ThreatReportAction.getThreatReportFilters()

Body
generatedReportIdstringRequired

ObjectId hex string of the threat report (returned by generateThreatReport).

Example: 696f83245ae7e4166f7347ae
Responses
200

Threat report filter configuration.

application/json
actionErrorsstring[]Optional
post/api/getThreatReportFilters

Download threat report as PDF

post

Generates or polls for a PDF rendering of a previously created threat report (via generateThreatReport). Polling semantics are identical to downloadReportPDF: set firstPollRequest: true on the first call, then false on subsequent polling calls.

Source: ThreatReportAction.downloadThreatReportPDF()

Body
reportIdstringOptional

ObjectId hex string of the threat report document.

Example: 696f83245ae7e4166f7347ae
organizationNamestringOptional

Organisation name to embed in the PDF header.

Example: Acme Corp
reportDatestringOptional

Human-readable date string to embed in the PDF.

Example: 2026-04-22
reportUrlstringOptional

URL at which the report page is hosted (rendered by the headless browser).

Example: https://app.example.com/dashboard/reports/threat/696f83245ae7e4166f7347ae
usernamestringOptional

Username of the requester to embed in the PDF.

Example: admin@example.com
firstPollRequestbooleanOptional

Set to true on the initial trigger call; false on subsequent polling calls.

Example: true
Responses
200

PDF generation status and base64 PDF when complete.

application/json
pdfstringOptional

Base64-encoded PDF content. Non-null only when status is COMPLETED.

Example: [REDACTED_BASE64_PDF]
statusstring · enumOptionalExample: COMPLETEDPossible values:
reportIdstringOptional

Report document ObjectId hex string.

Example: 696f83245ae7e4166f7347ae
actionErrorsstring[]Optional
post/api/downloadThreatReportPDF
200

PDF generation status and base64 PDF when complete.

Download a sample PDF report

post

Requests a pre-built sample PDF from the Puppeteer replay service (configured via the PUPPETEER_REPLAY_SERVICE_URL environment variable). Requires no request body. Returns a base64-encoded PDF on success.

Source: ReportAction.downloadSamplePdf()

Body
objectOptional

Empty body — no request parameters are required.

Responses
200

Sample PDF content.

application/json
pdfstringOptional

Base64-encoded sample PDF content.

Example: [REDACTED_BASE64_PDF]
statusstring · enumOptionalExample: COMPLETEDPossible values:
actionErrorsstring[]Optional
post/api/downloadSamplePdf

Fetch agent conversations by conversation ID

post

Returns up to 100 AgentConversationResult documents for a given conversationId, sorted by lastUpdatedAt ascending. Used by the agentic testing flow to replay or inspect a conversation.

Source: StartTestAction.fetchConversationsFromConversationId()

Body
conversationIdstringRequired

The conversation ID to retrieve agent conversation results for.

Example: conv_0ae3f12b9c7d41e5
Responses
200

List of conversation turn results ordered by creation time.

application/json
actionErrorsstring[]Optional
post/api/fetchConversationsFromConversationId

Last updated