Schema Reference

This page describes the authoritative request contract for POST /api/validate, derived from the same Zod schemas used by the validator.

Context normalization. AI Safety Gate evaluates exactly one policy family per request. The actionKindfield determines which context fields are used, and unrelated fields are automatically ignored by the system.

Request body

Field	Required	Type
action_kind	Yes	string
action_type	Yes	string
ai_output	Yes	object
context	No	object
job_id	No	string
plan	No	string
safety_context	No	object

Note: even if context is optional in the request parser, managed enforcement may still fail closed with WARN/BLOCK if required evidence is missing for the requested ActionKind.

Context (known fields)

Field	Type	Notes
account_id	string	Optional in schema; requiredness depends on ActionKind policies.
actionKind	string	Optional in schema; requiredness depends on ActionKind policies.
actionType	string	Optional in schema; requiredness depends on ActionKind policies.
actor_user_id	string	Optional in schema; requiredness depends on ActionKind policies.
allowed_scopes	array	Optional in schema; requiredness depends on ActionKind policies.
amount_usd	number	Optional in schema; requiredness depends on ActionKind policies.
authz_decision	string	Optional in schema; requiredness depends on ActionKind policies.
blast_radius_estimate	number	Optional in schema; requiredness depends on ActionKind policies.
case_id	string	Optional in schema; requiredness depends on ActionKind policies.
change_ticket	string	Optional in schema; requiredness depends on ActionKind policies.
compliance_context	string	Optional in schema; requiredness depends on ActionKind policies.
connector_id	string	Optional in schema; requiredness depends on ActionKind policies.
current_acl	string	Optional in schema; requiredness depends on ActionKind policies.
current_roles	array	Optional in schema; requiredness depends on ActionKind policies.
destination_id	string	Optional in schema; requiredness depends on ActionKind policies.
destination_verified	boolean	Optional in schema; requiredness depends on ActionKind policies.
idempotency_key	string	Optional in schema; requiredness depends on ActionKind policies.
invoice_id	string	Optional in schema; requiredness depends on ActionKind policies.
log_payload_preview	string	Optional in schema; requiredness depends on ActionKind policies.
maxRecords	number	Optional in schema; requiredness depends on ActionKind policies.
message_body	string	Optional in schema; requiredness depends on ActionKind policies.
payload_preview	string	Optional in schema; requiredness depends on ActionKind policies.
payload_schema	string	Optional in schema; requiredness depends on ActionKind policies.
purpose	string	Optional in schema; requiredness depends on ActionKind policies.
recent_actions_count	number	Optional in schema; requiredness depends on ActionKind policies.
recent_duplicate_count	number	Optional in schema; requiredness depends on ActionKind policies.
recipient_count	number	Optional in schema; requiredness depends on ActionKind policies.
recipient_source	string	Optional in schema; requiredness depends on ActionKind policies.
records_count	number	Optional in schema; requiredness depends on ActionKind policies.
recovery_plan	string	Optional in schema; requiredness depends on ActionKind policies.
request_id	string	Optional in schema; requiredness depends on ActionKind policies.
requested_acl	string	Optional in schema; requiredness depends on ActionKind policies.
requested_change	string	Optional in schema; requiredness depends on ActionKind policies.
requested_scopes	array	Optional in schema; requiredness depends on ActionKind policies.
resource_id	string	Optional in schema; requiredness depends on ActionKind policies.
resource_tenant_id	string	Optional in schema; requiredness depends on ActionKind policies.
rollback_plan	string	Optional in schema; requiredness depends on ActionKind policies.
rotation_plan	string	Optional in schema; requiredness depends on ActionKind policies.
session_user_id	string	Optional in schema; requiredness depends on ActionKind policies.
system_instructions	string	Optional in schema; requiredness depends on ActionKind policies.
template_id	string	Optional in schema; requiredness depends on ActionKind policies.
tenant_id	string	Optional in schema; requiredness depends on ActionKind policies.
time_window_minutes	number	Optional in schema; requiredness depends on ActionKind policies.
transaction_id	string	Optional in schema; requiredness depends on ActionKind policies.
user_input	string	Optional in schema; requiredness depends on ActionKind policies.
workflow	string	Optional in schema; requiredness depends on ActionKind policies.
workflowName	string	Optional in schema; requiredness depends on ActionKind policies.

Additional keys are allowed in context (passthrough).

Legal & Responsibility Notice

Summary

Informational only

Provided for general guidance. Not legal, compliance, security, or professional advice.

You control implementation

You are responsible for policies, prompts, integrations, workflows, and regulatory requirements.

Liability limitation

To the maximum extent permitted by law, the company disclaims liability for losses arising from use of this documentation or implementations based on it.