Test Run

Trigger Test Run for a specific Target

post

https://api.probe.splx.aihttps://us.api.probe.splx.ai

/api/workspaces/{workspaceId}/test-run/trigger

A Test Run is triggered for a specific target, each test run contains a set of probes used to check for specific vulnerabilities. These probes are pre-configured through the platform's UI.

Authorizations

API Key

X-Api-KeystringRequired

API Key for authentication

Path parameters

workspaceIdinteger · int32Required

Workspace Id.

Body

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

Request payload to trigger the execution of a Test Run.

targetIdinteger · int32Required

The id of the Target for which the Test Run will be triggered.

probeIdsinteger · int32[] · nullableRequired

The ids of the Probes that will be used in a Test Run.

namestringRequired

Name of the Test Run.

notifyWhenFinishedbooleanRequiredDefault: false

runAiAnalysisbooleanRequiredDefault: false

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

Internal Server Error

application/json

post

/api/workspaces/{workspaceId}/test-run/trigger

HTTPcURLJavaScriptPython

POST /api/workspaces/{workspaceId}/test-run/trigger HTTP/1.1
Host: api.probe.splx.ai
X-Api-Key: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 107

{
  "targetId": 1,
  "probeIds": [
    1,
    2,
    3
  ],
  "name": "SplXAI Test Run",
  "notifyWhenFinished": false,
  "runAiAnalysis": false
}

application/json-patch+jsonapplication/jsontext/jsonapplication/*+json

{
  "testRunId": 1
}

Cancel Test Run execution

post

https://api.probe.splx.aihttps://us.api.probe.splx.ai

/api/workspaces/{workspaceId}/test-run/{testRunId}/cancel

Immediately cancel Test Run execution.

Authorizations

API Key

X-Api-KeystringRequired

API Key for authentication

Path parameters

testRunIdinteger · int32Required

Test Run id.

workspaceIdinteger · int32Required

Workspace Id.

Responses

200

OK

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

Internal Server Error

application/json

post

/api/workspaces/{workspaceId}/test-run/{testRunId}/cancel

HTTPcURLJavaScriptPython

POST /api/workspaces/{workspaceId}/test-run/{testRunId}/cancel HTTP/1.1
Host: api.probe.splx.ai
X-Api-Key: YOUR_API_KEY
Accept: */*

No content