Target

Create a Target for a specific Workspace

post

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

/api/v2/workspaces/{workspaceId}/target

This endpoint allows you to create a new Target within a specified Workspace. The request body should contain the necessary details for the new Target.

Authorizations

API Key

X-Api-KeystringRequired

API Key for authentication

Path parameters

workspaceIdinteger · int32Required

Workspace Id.

Body

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

Request payload to create a new Target.

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/v2/workspaces/{workspaceId}/target

HTTPcURLJavaScriptPython

POST /api/v2/workspaces/{workspaceId}/target HTTP/1.1
Host: api.probe.splx.ai
X-Api-Key: YOUR_API_KEY
Content-Type: application/*+json
Accept: */*
Content-Length: 930

{
  "connection": {
    "config": {
      "apiKey": "api_key",
      "apiVersion": null,
      "deploymentName": "gpt-4o-deployment",
      "extraLlmParams": null,
      "systemPrompt": null,
      "url": "https://your-azure-openai-endpoint.openai.azure.com/"
    },
    "type": "AZURE_OPENAI"
  },
  "settings": {
    "concurrentRequests": true,
    "description": "This is an example target for demonstration purposes.",
    "environment": "PROD",
    "language": "en",
    "name": "Example Target",
    "predefinedResponses": [
      {
        "type": "text",
        "value": "This is a predefined response."
      }
    ],
    "ragFileId": "9c045336-a70f-4406-9800-4daabc18b2bb",
    "ragFileNumberOfFacts": 5,
    "rateLimit": 100,
    "supportedModes": [
      "text",
      "video"
    ],
    "systemPromptConfigurations": {
      "systemPromptConfidential": "This is a confidential part of the system prompt.",
      "systemPromptNotConfidential": "This is a non-confidential part of the system prompt.",
      "systemPromptTools": "These are the tools available for the system prompt."
    },
    "targetPresetId": "3d998f43-8a31-406e-86e6-066bbf43cb81"
  }
}

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

{
  "connection": {
    "config": null,
    "type": "text"
  },
  "id": 1,
  "scanId": 1,
  "settings": {
    "concurrentRequests": true,
    "description": "text",
    "environment": "text",
    "language": "text",
    "name": "text",
    "predefinedResponses": [
      {
        "type": "text",
        "value": "text"
      }
    ],
    "ragFile": {
      "ragFileId": "123e4567-e89b-12d3-a456-426614174000",
      "ragFileName": "text",
      "ragFileUrl": "text"
    },
    "ragFileNumberOfFacts": 1,
    "rateLimit": 1,
    "supportedModes": [
      "text"
    ],
    "systemPromptConfigurations": {
      "systemPromptConfidential": "text",
      "systemPromptNotConfidential": "text",
      "systemPromptTools": "text"
    },
    "targetPresetId": "123e4567-e89b-12d3-a456-426614174000",
    "workerPoolId": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Update a Target for a specific Workspace

patch

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

/api/v2/workspaces/{workspaceId}/target/{targetId}

This endpoint allows you to update an existing Target within a specified Workspace. The request body should contain the updated details for the Target.

Authorizations

API Key

X-Api-KeystringRequired

API Key for authentication

Path parameters

workspaceIdinteger · int32Required

Workspace Id.

targetIdinteger · int32Required

Target Id.

Body

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

Request payload to update an existing Target.

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

Internal Server Error

application/json

patch

/api/v2/workspaces/{workspaceId}/target/{targetId}

HTTPcURLJavaScriptPython

PATCH /api/v2/workspaces/{workspaceId}/target/{targetId} HTTP/1.1
Host: api.probe.splx.ai
X-Api-Key: YOUR_API_KEY
Content-Type: application/*+json
Accept: */*
Content-Length: 930

{
  "connection": {
    "config": {
      "apiKey": "api_key",
      "apiVersion": null,
      "deploymentName": "gpt-4o-deployment",
      "extraLlmParams": null,
      "systemPrompt": null,
      "url": "https://your-azure-openai-endpoint.openai.azure.com/"
    },
    "type": "AZURE_OPENAI"
  },
  "settings": {
    "concurrentRequests": true,
    "description": "This is an example target for demonstration purposes.",
    "environment": "PROD",
    "language": "en",
    "name": "Example Target",
    "predefinedResponses": [
      {
        "type": "text",
        "value": "This is a predefined response."
      }
    ],
    "ragFileId": "8a0104f2-f8c5-413d-9416-4abcad32e0ea",
    "ragFileNumberOfFacts": 5,
    "rateLimit": 100,
    "supportedModes": [
      "text",
      "video"
    ],
    "systemPromptConfigurations": {
      "systemPromptConfidential": "This is a confidential part of the system prompt.",
      "systemPromptNotConfidential": "This is a non-confidential part of the system prompt.",
      "systemPromptTools": "These are the tools available for the system prompt."
    },
    "targetPresetId": "45cadc0a-564f-49ec-ba4a-bf56e33fdc2a"
  }
}

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

{
  "connection": {
    "config": null,
    "type": "text"
  },
  "id": 1,
  "scanId": 1,
  "settings": {
    "concurrentRequests": true,
    "description": "text",
    "environment": "text",
    "language": "text",
    "name": "text",
    "predefinedResponses": [
      {
        "type": "text",
        "value": "text"
      }
    ],
    "ragFile": {
      "ragFileId": "123e4567-e89b-12d3-a456-426614174000",
      "ragFileName": "text",
      "ragFileUrl": "text"
    },
    "ragFileNumberOfFacts": 1,
    "rateLimit": 1,
    "supportedModes": [
      "text"
    ],
    "systemPromptConfigurations": {
      "systemPromptConfidential": "text",
      "systemPromptNotConfidential": "text",
      "systemPromptTools": "text"
    },
    "targetPresetId": "123e4567-e89b-12d3-a456-426614174000",
    "workerPoolId": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Retrieve a Target for a specific Workspace

get

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

/api/v2/workspaces/{workspaceId}/target/{targetId}

This endpoint allows you to retrieve details of a specific Target within a specified Workspace.

Authorizations

API Key

X-Api-KeystringRequired

API Key for authentication

Path parameters

workspaceIdinteger · int32Required

Workspace Id.

targetIdinteger · int32Required

Target Id.

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

Internal Server Error

application/json

get

/api/v2/workspaces/{workspaceId}/target/{targetId}

HTTPcURLJavaScriptPython

GET /api/v2/workspaces/{workspaceId}/target/{targetId} HTTP/1.1
Host: api.probe.splx.ai
X-Api-Key: YOUR_API_KEY
Accept: */*

{
  "connection": {
    "config": null,
    "type": "text"
  },
  "id": 1,
  "scanId": 1,
  "settings": {
    "concurrentRequests": true,
    "description": "text",
    "environment": "text",
    "language": "text",
    "name": "text",
    "predefinedResponses": [
      {
        "type": "text",
        "value": "text"
      }
    ],
    "ragFile": {
      "ragFileId": "123e4567-e89b-12d3-a456-426614174000",
      "ragFileName": "text",
      "ragFileUrl": "text"
    },
    "ragFileNumberOfFacts": 1,
    "rateLimit": 1,
    "supportedModes": [
      "text"
    ],
    "systemPromptConfigurations": {
      "systemPromptConfidential": "text",
      "systemPromptNotConfidential": "text",
      "systemPromptTools": "text"
    },
    "targetPresetId": "123e4567-e89b-12d3-a456-426614174000",
    "workerPoolId": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Delete Target from Workspace.

delete

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

/api/workspaces/{workspaceId}/target/{targetId}

Delete Target from the Workspace.

Authorizations

API Key

X-Api-KeystringRequired

API Key for authentication

Path parameters

targetIdinteger · int32Required

Target Id.

workspaceIdinteger · int32Required

Workspace Id.

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

Internal Server Error

application/json

delete

/api/workspaces/{workspaceId}/target/{targetId}

HTTPcURLJavaScriptPython

DELETE /api/workspaces/{workspaceId}/target/{targetId} HTTP/1.1
Host: api.probe.splx.ai
X-Api-Key: YOUR_API_KEY
Accept: */*

{
  "connection": {
    "config": null,
    "type": "text"
  },
  "id": 1,
  "scanId": 1,
  "settings": {
    "concurrentRequests": true,
    "description": "text",
    "environment": "text",
    "language": "text",
    "name": "text",
    "predefinedResponses": [
      {
        "type": "text",
        "value": "text"
      }
    ],
    "ragFile": {
      "ragFileId": "123e4567-e89b-12d3-a456-426614174000",
      "ragFileName": "text",
      "ragFileUrl": "text"
    },
    "ragFileNumberOfFacts": 1,
    "rateLimit": 1,
    "supportedModes": [
      "text"
    ],
    "systemPromptConfigurations": {
      "systemPromptConfidential": "text",
      "systemPromptNotConfidential": "text",
      "systemPromptTools": "text"
    },
    "targetPresetId": "123e4567-e89b-12d3-a456-426614174000",
    "workerPoolId": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Target overview PDF report

get

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

/api/workspaces/{workspaceId}/target/{id}/report

Generate a PDF report of target overview, which includes target details and a summary of the passed and failed test cases for each latest probe run execution.

Authorizations

API Key

X-Api-KeystringRequired

API Key for authentication

Path parameters

idinteger · int32Required

Target Id.

workspaceIdinteger · int32Required

Workspace Id.

Responses

200

OK

application/jsonapplication/pdf

Responsestring · binary

400

Bad Request

application/jsonapplication/pdf

401

Unauthorized

application/jsonapplication/pdf

403

Forbidden

application/jsonapplication/pdf

500

Internal Server Error

application/jsonapplication/pdf

get

/api/workspaces/{workspaceId}/target/{id}/report

HTTPcURLJavaScriptPython

GET /api/workspaces/{workspaceId}/target/{id}/report HTTP/1.1
Host: api.probe.splx.ai
X-Api-Key: YOUR_API_KEY
Accept: */*

binary

Get Target types.

get

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

/api/target/types

Retrieves a list of available Target Types (e.g. Private With RAG), including metadata and associated probe settings.

Authorizations

API Key

X-Api-KeystringRequired

API Key for authentication

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

Internal Server Error

application/json

get

/api/target/types

HTTPcURLJavaScriptPython

GET /api/target/types HTTP/1.1
Host: api.probe.splx.ai
X-Api-Key: YOUR_API_KEY
Accept: */*

[
  {
    "details": [
      {
        "isRecommended": true,
        "probeId": 1,
        "weight": "LOW"
      }
    ],
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "label": "text"
  }
]

Retrieve overall scores and category breakdown for a Target

get

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

/api/workspaces/{workspaceId}/target/{targetId}/scores

Returns the overall score and scores per category for a specific Target within a Workspace. Scores are calculated based on the latest probe run results and provide insights into security vulnerabilities, compliance issues, and other risk factors.

Authorizations

API Key

X-Api-KeystringRequired

API Key for authentication

Path parameters

workspaceIdinteger · int32Required

Workspace Id.

targetIdinteger · int32Required

Target Id.

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

Internal Server Error

application/json

get

/api/workspaces/{workspaceId}/target/{targetId}/scores

HTTPcURLJavaScriptPython

GET /api/workspaces/{workspaceId}/target/{targetId}/scores HTTP/1.1
Host: api.probe.splx.ai
X-Api-Key: YOUR_API_KEY
Accept: */*

{
  "latestExecutionDate": "2025-11-13T03:43:56.221Z",
  "overallScore": 1,
  "scores": {
    "ANY_ADDITIONAL_PROPERTY": 1
  },
  "simulatedAttacks": 1,
  "successfulAttacks": 1
}

Retrieve test runs for a Target

get

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

/api/workspaces/{workspaceId}/target/{targetId}/test-runs

Returns a list of test runs for a specific Target within a Workspace. This includes all test runs with their execution status, progress, probes and result summaries.

Authorizations

API Key

X-Api-KeystringRequired

API Key for authentication

Path parameters

workspaceIdinteger · int32Required

Workspace Id.

targetIdinteger · int32Required

Target Id.

Responses

200

OK

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

Internal Server Error

application/json

get

/api/workspaces/{workspaceId}/target/{targetId}/test-runs

HTTPcURLJavaScriptPython

GET /api/workspaces/{workspaceId}/target/{targetId}/test-runs HTTP/1.1
Host: api.probe.splx.ai
X-Api-Key: YOUR_API_KEY
Accept: */*

[
  {
    "errorCount": 1,
    "executionDate": "2025-11-13T03:43:56.221Z",
    "failedCount": 1,
    "id": 1,
    "name": "text",
    "passedCount": 1,
    "probes": [
      "text"
    ],
    "progress": 1,
    "startedBy": "text",
    "status": "text",
    "totalCount": 1
  }
]