SpecifyDocs

Security policy simulate

/v1/security/policies/{id}/simulations

Signed-in sessionLaunch key product.securityOperation security_policy_simulate

People see the devices that run their agents, their security posture and the events those devices report.

Path parameters

idstringRequired

Body

expectedAuthorizationVersionstring
pathAccess"delete" | "read" | "write"[]
operationJsonstringRequired

Returns

draftobjectRequired
draftRevisionHashstringRequired
scope"organization" | "person" | "team"Required
subjectIncludedbooleanRequired
versionnumberRequired
decision"allow" | "deny" | "observe"Required
matchedRuleIdsstring[]Required
exceptionIdsstring[]Required
semanticRuleIdsstring[]Required
reasonsstring[]Required
coverageState"degraded" | "enforced" | "observed"Required
revisionHashstringRequired

Errors

400, 401, 403, 404, 409, 429 and 503 return {"error": {"code", "message", "correlationId"}}.