Policy

List Policies

GET
/api/policy/list

List active Policies for the workspace resolved by your API key.

Authorizations

  • Authorizationstringheaderrequired

    API Key required. Format: Bearer wc-your-api-key

Headers

  • whitecircle-versionstringrequired

    API Version

    Example: "2026-06-01"

Query Parameters

  • content_typenull | enum<string>

    Available options: session, artifact, any

    Example: "session"

  • applies_tonull | enum<string>

    Available options: input, output, any

    Example: "input"

  • modenull | enum<string>

    Available options: prod, shadow

    Example: "prod"

Response

application/json

Success

  • idstringrequired

  • namestringrequired

  • rulesobject[]required

    Rules defining content to flag or allow. At least one rule contains flagged_content.

    Show child attributes
    • rules.idstring<uuid>required

    • rules.flagged_contentstring | null

      Content that triggers a policy violation.

    • rules.allowed_contentstring | null

      Content that the policy must allow.

  • content_typeenum<string>required

    Available options: session, artifact, any

    Example: "session"

  • event_selector_listobject[]required

    Structured policy selector used by Events-aware policy matching.

    Show child attributes
    • event_selector_list.typeenum<string>required

      Runtime surface selected by a policy for Events-aware matching.

      Available options: message, tool, function, agent, artifact, reasoning

    • event_selector_list.fieldstring | null

    • event_selector_list.kindstring | null

  • role_listenum<string>[]required

    Role restriction used by the new policy targeting model. Empty role lists mean any role.

    Available options: user, assistant

  • applies_toenum<string>required

    Available options: input, output, any

    Example: "input"

  • modeenum<string>required

    Available options: prod, shadow

    Example: "prod"

  • created_atstring<date-time>required

  • stateenum<string>required

    Available options: active, inactive, draft

    Example: "active"

  • country_codesstring[]required

  • severity_level_idstring<uuid> | null