Skip to content

List AI policies

GET/ai/policies

Returns the current set of AI governance policies for the tenant, including action policies (what the AI is allowed to do) and policy settings (configuration parameters such as content filters and response length limits). Use to audit the active governance posture.

Request

This endpoint takes no parameters and no request body.

Responses

200 Current AI governance policy bundle

Content type application/json, object · AiPolicyBundleV1.

FieldTypeRequiredDescription
action_policiesarray of objectNo

Per-action permission rules that govern what the AI Copilot is allowed to do.

action_policies[].actionstringYes

The AI action identifier (e.g. "send_email", "read_crm_data").

action_policies[].allowedbooleanYes

Whether the action is permitted.

action_policies[].requires_approvalbooleanNo

When true, the action is queued for human approval before execution.

Default: false

policy_settingsobjectNo

Key-value configuration parameters for AI content safety and behaviour.

Example

{
  "action_policies": [
    {
      "action": "send_email",
      "allowed": false,
      "requires_approval": true
    },
    {
      "action": "read_crm_data",
      "allowed": true,
      "requires_approval": false
    }
  ],
  "policy_settings": {
    "content_filter_level": "moderate",
    "max_response_tokens": 2048,
    "allow_external_urls": false,
    "pii_redaction": true
  }
}

Example request

curl -X GET "https://{tenant}.faciotech.net/api/v1/ai/policies" \
  -H "Accept: application/json"
Loading