simulator

Run Preview

Execute a live search and apply policy evaluation to show per-result allow/deny.

Readiness guards:

  • Entitlement: access_simulator feature (Growth+)
  • Connector: must be connected with a valid search_config
  • Principals: at least one active principal must exist in the org
  • Policies: at least one active policy must exist in the org

Denied results never expose content_preview. Emits a simulator_preview_executed audit event on success.

post/api/simulator/preview

Request

  • Base URL: https://www.gateco.ai (the document declares no server; this is the origin it was published from)
  • URL: https://www.gateco.ai/api/simulator/preview
  • Auth: OAuth 2 (password, token URL /api/auth/login)

Request body

principal_idstring required
connector_idstring required
querystring required
top_kinteger
search_mode'vector' | 'keyword' | 'hybrid'
alphanumber nullable

Response

Successful Response

outcomestring required
querystring required
principal_namestring required
connector_namestring required
search_modestring required
total_resultsinteger required
allowed_resultsobject[] required
denied_resultsobject[] required
policy_traceobject[] required
timing_msnumber required

Changes

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