ZEzeropath
Security Compass

Test the SD Elements connection against a project

Validate the dashboard-saved SD Elements credentials by probing one project, returning the number of risk-relevant countermeasures visible on it. Fails with 400 when the saved token cannot reach the project. This endpoint never accepts an SD Elements API token — enter or rotate credentials in the ZeroPath dashboard instead.

post/api/v2/securityCompass/testConnection

Request

  • Base URL
    https://zeropath.com
  • Auth
    API key in header X-ZeroPath-API-Token-Id and API key in header X-ZeroPath-API-Token-Secret

Request body

organizationIdstring required

Organization that owns the integration.

sdeBaseUrlstring uri required

Base URL of the SD Elements tenant to probe, e.g. https://acme.sdelements.com. Authentication uses the API token saved in the dashboard — this endpoint never accepts credentials.

sdeProjectIdstring required

SD Elements project id to probe (the numeric id from the project URL).

Response

Probe result with the countermeasure count

successboolean required
countermeasureCountinteger

Number of risk-relevant countermeasures visible on the probed project.

Changes

No recorded changes to this operation across all 1 revision of this API.