{
    "openapi": "3.1.0",
    "info": {
        "title": "WhiteCircle API Backend",
        "description": "Authentication: Bearer API Key Required",
        "license": {
            "name": ""
        },
        "version": "2025-12-01"
    },
    "servers": [
        {
            "url": "https://eu.whitecircle.com"
        },
        {
            "url": "https://us.whitecircle.com"
        }
    ],
    "paths": {
        "/api/artifact/check": {
            "post": {
                "tags": [
                    "Artifact"
                ],
                "operationId": "artifact_check",
                "parameters": [
                    {
                        "name": "whitecircle-version",
                        "in": "header",
                        "description": "API Version",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2025-12-01"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Artifact check completed",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ArtifactCheckResponse"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ],
                "summary": "Check artifact content",
                "description": "Check a single content artifact against deployment policies. Currently supports image artifacts.",
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/ArtifactCheckRequest"
                            }
                        }
                    },
                    "required": true
                }
            }
        },
        "/api/artifact/get_by_id": {
            "get": {
                "tags": [
                    "Artifact"
                ],
                "operationId": "artifact_get_by_id",
                "parameters": [
                    {
                        "name": "whitecircle-version",
                        "in": "header",
                        "description": "API Version",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2025-12-01"
                    },
                    {
                        "name": "internal_artifact_id",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": [
                                "string",
                                "null"
                            ]
                        }
                    },
                    {
                        "name": "external_artifact_id",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": [
                                "string",
                                "null"
                            ]
                        }
                    },
                    {
                        "name": "deployment_id",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": [
                                "string",
                                "null"
                            ]
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Artifact found",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ArtifactCheckResponse"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ],
                "summary": "Get artifact by ID",
                "description": "Retrieve artifact check results by internal_artifact_id or external_artifact_id."
            }
        },
        "/api/metric/create": {
            "post": {
                "tags": [
                    "Metric"
                ],
                "operationId": "create_metric_v1",
                "parameters": [
                    {
                        "name": "whitecircle-version",
                        "in": "header",
                        "description": "API Version",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2025-12-01"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreatePolicyRequest"
                            }
                        }
                    },
                    "required": true
                },
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PublicPolicy"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ]
            }
        },
        "/api/metric/delete": {
            "post": {
                "tags": [
                    "Metric"
                ],
                "operationId": "delete_metric_v1",
                "parameters": [
                    {
                        "name": "whitecircle-version",
                        "in": "header",
                        "description": "API Version",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2025-12-01"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/DeletePolicyPublicRequest"
                            }
                        }
                    },
                    "required": true
                },
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PublicPolicy"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ]
            }
        },
        "/api/metric/get_by_id": {
            "get": {
                "tags": [
                    "Metric"
                ],
                "operationId": "get_by_id_metric_v1",
                "parameters": [
                    {
                        "name": "whitecircle-version",
                        "in": "header",
                        "description": "API Version",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2025-12-01"
                    },
                    {
                        "name": "id",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PublicPolicy"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ]
            }
        },
        "/api/metric/list": {
            "get": {
                "tags": [
                    "Metric"
                ],
                "operationId": "list_metric_v1",
                "parameters": [
                    {
                        "name": "whitecircle-version",
                        "in": "header",
                        "description": "API Version",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2025-12-01"
                    },
                    {
                        "name": "deployment_id",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": [
                                "string",
                                "null"
                            ]
                        }
                    },
                    {
                        "name": "content_type",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "oneOf": [
                                {
                                    "type": "null"
                                },
                                {
                                    "$ref": "#/components/schemas/PublicContentType"
                                }
                            ]
                        }
                    },
                    {
                        "name": "applies_to",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "oneOf": [
                                {
                                    "type": "null"
                                },
                                {
                                    "$ref": "#/components/schemas/PublicAppliesTo"
                                }
                            ]
                        }
                    },
                    {
                        "name": "mode",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "oneOf": [
                                {
                                    "type": "null"
                                },
                                {
                                    "$ref": "#/components/schemas/PublicPolicyMode"
                                }
                            ]
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/PublicPolicy"
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ]
            }
        },
        "/api/metric/update": {
            "post": {
                "tags": [
                    "Metric"
                ],
                "operationId": "update_metric_v1",
                "parameters": [
                    {
                        "name": "whitecircle-version",
                        "in": "header",
                        "description": "API Version",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2025-12-01"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdatePolicyRequest"
                            }
                        }
                    },
                    "required": true
                },
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PublicPolicy"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ]
            }
        },
        "/api/policy/create": {
            "post": {
                "tags": [
                    "Policy"
                ],
                "operationId": "create_v1",
                "parameters": [
                    {
                        "name": "whitecircle-version",
                        "in": "header",
                        "description": "API Version",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2025-12-01"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreatePolicyRequest"
                            }
                        }
                    },
                    "required": true
                },
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PublicPolicy"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ]
            }
        },
        "/api/policy/delete": {
            "post": {
                "tags": [
                    "Policy"
                ],
                "operationId": "delete_v1",
                "parameters": [
                    {
                        "name": "whitecircle-version",
                        "in": "header",
                        "description": "API Version",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2025-12-01"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/DeletePolicyPublicRequest"
                            }
                        }
                    },
                    "required": true
                },
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PublicPolicy"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ]
            }
        },
        "/api/policy/get_by_id": {
            "get": {
                "tags": [
                    "Policy"
                ],
                "operationId": "get_by_id_v1",
                "parameters": [
                    {
                        "name": "whitecircle-version",
                        "in": "header",
                        "description": "API Version",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2025-12-01"
                    },
                    {
                        "name": "id",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PublicPolicy"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ]
            }
        },
        "/api/policy/list": {
            "get": {
                "tags": [
                    "Policy"
                ],
                "operationId": "list_v1",
                "parameters": [
                    {
                        "name": "whitecircle-version",
                        "in": "header",
                        "description": "API Version",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2025-12-01"
                    },
                    {
                        "name": "deployment_id",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": [
                                "string",
                                "null"
                            ]
                        }
                    },
                    {
                        "name": "content_type",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "oneOf": [
                                {
                                    "type": "null"
                                },
                                {
                                    "$ref": "#/components/schemas/PublicContentType"
                                }
                            ]
                        }
                    },
                    {
                        "name": "applies_to",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "oneOf": [
                                {
                                    "type": "null"
                                },
                                {
                                    "$ref": "#/components/schemas/PublicAppliesTo"
                                }
                            ]
                        }
                    },
                    {
                        "name": "mode",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "oneOf": [
                                {
                                    "type": "null"
                                },
                                {
                                    "$ref": "#/components/schemas/PublicPolicyMode"
                                }
                            ]
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/PublicPolicy"
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ]
            }
        },
        "/api/policy/update": {
            "post": {
                "tags": [
                    "Policy"
                ],
                "operationId": "update_v1",
                "parameters": [
                    {
                        "name": "whitecircle-version",
                        "in": "header",
                        "description": "API Version",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2025-12-01"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/UpdatePolicyRequest"
                            }
                        }
                    },
                    "required": true
                },
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/PublicPolicy"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ]
            }
        },
        "/api/session/check": {
            "post": {
                "tags": [
                    "Session"
                ],
                "operationId": "check_v3",
                "parameters": [
                    {
                        "name": "whitecircle-version",
                        "in": "header",
                        "description": "API Version",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2025-12-01"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CheckRequestV3"
                            }
                        }
                    },
                    "required": true
                },
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CheckResponseV3"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ]
            }
        },
        "/api/session/get_by_id": {
            "get": {
                "tags": [
                    "Session"
                ],
                "operationId": "get_by_id_v3",
                "parameters": [
                    {
                        "name": "whitecircle-version",
                        "in": "header",
                        "description": "API Version",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2025-12-01"
                    },
                    {
                        "name": "deployment_id",
                        "in": "query",
                        "description": "Optional deployment ID to validate session ownership",
                        "required": false,
                        "schema": {
                            "type": [
                                "string",
                                "null"
                            ]
                        }
                    },
                    {
                        "name": "external_session_id",
                        "in": "query",
                        "description": "Find check results by external session ID (your tracking identifier)",
                        "required": false,
                        "schema": {
                            "type": [
                                "string",
                                "null"
                            ]
                        }
                    },
                    {
                        "name": "internal_session_id",
                        "in": "query",
                        "description": "Find check results by internal session ID (system-generated UUID)",
                        "required": false,
                        "schema": {
                            "type": [
                                "string",
                                "null"
                            ]
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/GetByIdResponseV3"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ]
            }
        },
        "/api/user/risk": {
            "get": {
                "tags": [
                    "User"
                ],
                "operationId": "risk_v3",
                "parameters": [
                    {
                        "name": "whitecircle-version",
                        "in": "header",
                        "description": "API Version",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2025-12-01"
                    },
                    {
                        "name": "email",
                        "in": "query",
                        "description": "User email address (provide exactly one of email, id, or ip)",
                        "required": false,
                        "schema": {
                            "type": [
                                "string",
                                "null"
                            ]
                        }
                    },
                    {
                        "name": "id",
                        "in": "query",
                        "description": "External user ID (provide exactly one of email or id)",
                        "required": false,
                        "schema": {
                            "type": [
                                "string",
                                "null"
                            ]
                        },
                        "example": "user-123"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UserRiskResponse"
                                },
                                "example": {
                                    "action": "warn",
                                    "action_expires_at": "2026-04-05T10:00:00Z",
                                    "strikes": [
                                        {
                                            "points": 10,
                                            "created_at": 1770612473,
                                            "expires_at": 1771217273,
                                            "reason": "session.flagged",
                                            "internal_session_id": "5f8a31d6-4b2f-4e61-88d5-cc537e4af79e",
                                            "external_session_id": "session-456",
                                            "appeal": {
                                                "time": 1770612573,
                                                "status": "appeal.in_review"
                                            },
                                            "policy": {
                                                "id": "8d3d8fad-0df7-443f-a6df-5445e48a8eaf",
                                                "name": "Adult Content",
                                                "severity": "high"
                                            }
                                        }
                                    ],
                                    "total_strike_points": 10
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ],
                "x-codeSamples": [
                    {
                        "lang": "cURL",
                        "label": "cURL (email)",
                        "source": "curl --request GET \\\n  --url 'https://eu.whitecircle.com/api/user/risk?email=user%40example.com' \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'whitecircle-version: 2025-12-01'"
                    },
                    {
                        "lang": "cURL",
                        "label": "cURL (id)",
                        "source": "curl --request GET \\\n  --url 'https://eu.whitecircle.com/api/user/risk?id=user-123' \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'whitecircle-version: 2025-12-01'"
                    }
                ]
            }
        },
        "/api/user/strike": {
            "post": {
                "tags": [
                    "User"
                ],
                "operationId": "strike_v3",
                "parameters": [
                    {
                        "name": "whitecircle-version",
                        "in": "header",
                        "description": "API Version",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2025-12-01"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateUserStrikeRequest"
                            },
                            "example": {
                                "policy_id": "8d3d8fad-0df7-443f-a6df-5445e48a8eaf",
                                "severity_level_id": "f43f4c73-b2d9-48b8-a79f-868e3f958d37",
                                "id": "user-123",
                                "email": "user@example.com",
                                "ip": "203.0.113.10",
                                "external_session_id": "session-456",
                                "internal_session_id": "5f8a31d6-4b2f-4e61-88d5-cc537e4af79e"
                            }
                        }
                    },
                    "required": true
                },
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CreateUserStrikeResponse"
                                },
                                "example": {
                                    "action": "warn",
                                    "action_expires_at": "2026-04-05T10:00:00Z",
                                    "strike": {
                                        "severity": "high",
                                        "points": 10,
                                        "created_at": 1770612473,
                                        "expires_at": 1771217273,
                                        "reason": "session.flagged",
                                        "internal_session_id": "5f8a31d6-4b2f-4e61-88d5-cc537e4af79e",
                                        "external_session_id": "session-456",
                                        "appeal": null,
                                        "policy": {
                                            "id": "8d3d8fad-0df7-443f-a6df-5445e48a8eaf",
                                            "name": "Adult Content",
                                            "severity": "high"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ],
                "x-codeSamples": [
                    {
                        "lang": "cURL",
                        "label": "cURL",
                        "source": "curl --request POST \\\n  --url 'https://eu.whitecircle.com/api/user/strike' \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --header 'whitecircle-version: 2025-12-01' \\\n  --data '{\"policy_id\":\"8d3d8fad-0df7-443f-a6df-5445e48a8eaf\",\"severity_level_id\":\"f43f4c73-b2d9-48b8-a79f-868e3f958d37\",\"id\":\"user-123\",\"email\":\"user@example.com\",\"external_session_id\":\"session-456\"}'"
                    }
                ]
            }
        },
        "/api/user/strike/appeal": {
            "get": {
                "tags": [
                    "User"
                ],
                "operationId": "get_strike_appeal_v3",
                "parameters": [
                    {
                        "name": "whitecircle-version",
                        "in": "header",
                        "description": "API Version",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2025-12-01"
                    },
                    {
                        "name": "strike_id",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "format": "uuid"
                        },
                        "example": "4aa6b3e7-66fb-4865-8d54-6f7f2faa49c4"
                    },
                    {
                        "name": "appeal_id",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": [
                                "string",
                                "null"
                            ],
                            "format": "uuid"
                        },
                        "example": "8f3a6f48-6f63-4ac0-b3ec-6beefca3e8c2"
                    },
                    {
                        "name": "session_id",
                        "in": "query",
                        "required": false,
                        "schema": {
                            "type": [
                                "string",
                                "null"
                            ]
                        },
                        "example": "session-456"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/UserStrikeAppealResponse"
                                },
                                "example": {
                                    "appeal_id": "8f3a6f48-6f63-4ac0-b3ec-6beefca3e8c2",
                                    "status": "appeal.in_review",
                                    "current_points": 10,
                                    "current_level": "warn",
                                    "updated_by": "reviewer-42"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ],
                "x-codeSamples": [
                    {
                        "lang": "cURL",
                        "label": "cURL (appeal_id)",
                        "source": "curl --request GET \\\n  --url 'https://eu.whitecircle.com/api/user/strike/appeal?appeal_id=8f3a6f48-6f63-4ac0-b3ec-6beefca3e8c2' \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'whitecircle-version: 2025-12-01'"
                    },
                    {
                        "lang": "cURL",
                        "label": "cURL (strike_id)",
                        "source": "curl --request GET \\\n  --url 'https://eu.whitecircle.com/api/user/strike/appeal?strike_id=4aa6b3e7-66fb-4865-8d54-6f7f2faa49c4' \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'whitecircle-version: 2025-12-01'"
                    }
                ]
            },
            "post": {
                "tags": [
                    "User"
                ],
                "operationId": "create_strike_appeal_v3",
                "parameters": [
                    {
                        "name": "whitecircle-version",
                        "in": "header",
                        "description": "API Version",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "example": "2025-12-01"
                    }
                ],
                "requestBody": {
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/CreateUserStrikeAppealRequest"
                            },
                            "example": {
                                "reason": "This strike was applied by mistake.",
                                "strike_id": "4aa6b3e7-66fb-4865-8d54-6f7f2faa49c4",
                                "session_id": "session-456"
                            }
                        }
                    },
                    "required": true
                },
                "responses": {
                    "200": {
                        "description": "Success",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/CreateUserStrikeAppealResponse"
                                },
                                "example": {
                                    "appeal_id": "8f3a6f48-6f63-4ac0-b3ec-6beefca3e8c2",
                                    "status": "appeal.in_review"
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Bad Request"
                    }
                },
                "security": [
                    {
                        "bearerAuth": []
                    }
                ],
                "x-codeSamples": [
                    {
                        "lang": "cURL",
                        "label": "cURL",
                        "source": "curl --request POST \\\n  --url 'https://eu.whitecircle.com/api/user/strike/appeal' \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --header 'whitecircle-version: 2025-12-01' \\\n  --data '{\"reason\":\"This strike was applied by mistake.\",\"strike_id\":\"4aa6b3e7-66fb-4865-8d54-6f7f2faa49c4\",\"session_id\":\"session-456\"}'"
                    }
                ]
            }
        }
    },
    "components": {
        "schemas": {
            "ArtifactCheckRequest": {
                "type": "object",
                "required": [
                    "content",
                    "deployment_id"
                ],
                "properties": {
                    "content": {
                        "$ref": "#/components/schemas/ArtifactContent",
                        "description": "Artifact content payload. See Content Constraints in the docs for supported formats and limits."
                    },
                    "deployment_id": {
                        "type": "string",
                        "description": "The deployment ID to check against"
                    },
                    "external_artifact_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Your custom artifact tracking ID"
                    },
                    "external_session_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Attach artifact to an existing session by your external session ID"
                    },
                    "internal_session_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Attach artifact to an existing session by internal UUID"
                    },
                    "metadata": {
                        "oneOf": [
                            {
                                "type": "null"
                            },
                            {
                                "$ref": "#/components/schemas/IndexMap"
                            }
                        ],
                        "description": "Arbitrary key-value metadata"
                    }
                },
                "description": "Request body for checking a content artifact.",
                "example": {
                    "content": {
                        "kind": "image",
                        "url": "https://cdn.example.com/uploads/avatar-42.jpg"
                    },
                    "deployment_id": "your-deployment-id",
                    "external_artifact_id": "user-avatar-42",
                    "external_session_id": "user-session-123"
                }
            },
            "ArtifactCheckResponse": {
                "type": "object",
                "required": [
                    "status",
                    "kind",
                    "internal_artifact_id",
                    "policies"
                ],
                "properties": {
                    "status": {
                        "type": "string",
                        "description": "Check status: \"completed\""
                    },
                    "flagged": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "true if any policy was violated"
                    },
                    "policies": {
                        "type": "object",
                        "additionalProperties": {
                            "$ref": "#/components/schemas/ArtifactPolicyStatus"
                        },
                        "propertyNames": {
                            "type": "string"
                        },
                        "description": "Map of policy ID to violation result"
                    },
                    "internal_artifact_id": {
                        "type": "string",
                        "description": "System-generated UUID for this artifact"
                    },
                    "external_artifact_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Your custom artifact ID (if provided)"
                    },
                    "internal_session_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Internal ID of the linked session (if attached)"
                    },
                    "external_session_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "External ID of the linked session (if provided)"
                    },
                    "created_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ISO 8601 creation timestamp"
                    },
                    "updated_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ISO 8601 last update timestamp"
                    },
                    "kind": {
                        "type": "string",
                        "description": "Echo of content.kind from request"
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Informational note (only present when applicable)"
                    }
                },
                "description": "Artifact check result.",
                "example": {
                    "flagged": true,
                    "policies": {
                        "7eb45909-35a3-4bcb-81b9-049fc7413dba": {
                            "name": "No Explicit Content",
                            "flagged": true,
                            "flagged_source": ["image"]
                        },
                        "ad1f958e-e167-4e06-befc-434fd42563c9": {
                            "name": "No Violence",
                            "flagged": false,
                            "flagged_source": []
                        }
                    },
                    "kind": "image",
                    "status": "completed",
                    "created_at": "2025-12-01T10:30:00Z",
                    "updated_at": "2025-12-01T10:30:00Z",
                    "internal_artifact_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                    "external_artifact_id": "user-avatar-42",
                    "internal_session_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
                    "external_session_id": "user-session-123"
                }
            },
            "ArtifactContent": {
                "type": "object",
                "required": [
                    "kind"
                ],
                "properties": {
                    "data": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Base64-encoded content (with or without data: URI prefix). Exactly one of url or data required"
                    },
                    "kind": {
                        "type": "string",
                        "description": "Artifact kind. Currently supported: \"image\""
                    },
                    "mime_type": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "MIME type (e.g., \"image/png\"). Optional \u2014 automatically detected from image bytes"
                    },
                    "name": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Display name (e.g., \"photo.png\")"
                    },
                    "url": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "URL to fetch content from. Exactly one of url or data required"
                    }
                },
                "description": "Artifact content payload.",
                "example": {
                    "kind": "image",
                    "url": "https://cdn.example.com/uploads/avatar-42.jpg"
                }
            },
            "ArtifactGetQuery": {
                "type": "object",
                "properties": {
                    "internal_artifact_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Internal artifact ID (returned from the check endpoint)"
                    },
                    "deployment_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Override deployment resolved from API key"
                    },
                    "external_artifact_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Your custom artifact tracking ID"
                    }
                },
                "description": "Query parameters for retrieving an artifact."
            },
            "ArtifactPolicyStatus": {
                "type": "object",
                "required": [
                    "flagged",
                    "flagged_source",
                    "name"
                ],
                "properties": {
                    "flagged": {
                        "type": "boolean",
                        "description": "Whether this policy was violated"
                    },
                    "flagged_source": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        },
                        "description": "Content types that triggered the violation (e.g., [\"image\"])"
                    },
                    "name": {
                        "type": "string",
                        "description": "Policy display name"
                    }
                },
                "description": "Policy violation result for an artifact check.",
                "example": {
                    "flagged": true,
                    "flagged_source": ["image"],
                    "name": "No Explicit Content"
                }
            },
            "AssistantInfoV3": {
                "type": "object",
                "properties": {
                    "latency": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "format": "double"
                    },
                    "model_name": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "provider_url": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                }
            },
            "CheckRequestV3": {
                "type": "object",
                "required": [
                    "messages",
                    "deployment_id"
                ],
                "properties": {
                    "messages": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/RequestChatMessageV3"
                        },
                        "description": "Array of chat messages to analyze for policy violations"
                    },
                    "deployment_id": {
                        "type": "string",
                        "description": "The deployment ID to check against"
                    },
                    "external_session_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Optional external identifier for tracking this session"
                    },
                    "include_context": {
                        "type": [
                            "boolean",
                            "null"
                        ],
                        "description": "Include previous conversation context. Defaults to true if external_session_id is provided"
                    },
                    "metadata": {
                        "type": "object",
                        "description": "Optional session-level metadata",
                        "additionalProperties": {
                            "type": "object",
                            "additionalProperties": {},
                            "propertyNames": {
                                "type": "string"
                            }
                        },
                        "propertyNames": {
                            "type": "string"
                        }
                    },
                    "policies": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "string"
                        },
                        "description": "Optional list of specific policy IDs to check against. If omitted, all deployment policies are used"
                    }
                },
                "example": {
                    "deployment_id": "your-deployment-id",
                    "external_session_id": "user-session-123",
                    "include_context": true,
                    "messages": [
                        {
                            "content": "Hello, can you help me with something?",
                            "metadata": {
                                "message": {
                                    "id": "msg-123"
                                },
                                "user": {
                                    "email": "user@example.com",
                                    "id": "user-456"
                                }
                            },
                            "role": "user"
                        },
                        {
                            "content": [
                                {
                                    "text": "Of course! I'd be happy to help you.",
                                    "type": "text"
                                }
                            ],
                            "metadata": {
                                "assistant": {
                                    "latency": 1.2,
                                    "model_name": "gpt-4o-mini"
                                }
                            },
                            "role": "assistant"
                        }
                    ],
                    "metadata": {
                        "session": {
                            "timestamp": "2025-12-01T10:00:00Z"
                        }
                    }
                }
            },
            "CheckResponseV3": {
                "type": "object",
                "required": [
                    "flagged",
                    "internal_session_id",
                    "policies"
                ],
                "properties": {
                    "external_session_id": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "flagged": {
                        "type": "boolean"
                    },
                    "internal_session_id": {
                        "type": "string"
                    },
                    "note": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "policies": {
                        "type": "object",
                        "additionalProperties": {
                            "$ref": "#/components/schemas/PolicyStatusV3"
                        },
                        "propertyNames": {
                            "type": "string"
                        }
                    }
                },
                "example": {
                    "flagged": true,
                    "internal_session_id": "123e4567-e89b-12d3-a456-426614174000",
                    "external_session_id": "user-session-001",
                    "policies": {
                        "70289e06-9111-463e-b121-7247c2b7bfbd": {
                            "flagged": false,
                            "flagged_source": [],
                            "name": "No PII Sharing"
                        },
                        "a4a91875-1e54-42d7-b9b0-a75dfebeb057": {
                            "flagged": true,
                            "flagged_source": [
                                "text"
                            ],
                            "name": "Drugs"
                        }
                    }
                }
            },
            "CreatePolicyRequest": {
                "type": "object",
                "required": [
                    "name",
                    "flagged_content"
                ],
                "properties": {
                    "name": {
                        "type": "string"
                    },
                    "allowed_content": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "flagged_content": {
                        "type": "string"
                    },
                    "applies_to": {
                        "oneOf": [
                            {
                                "type": "null"
                            },
                            {
                                "$ref": "#/components/schemas/PublicAppliesTo"
                            }
                        ]
                    },
                    "content_type": {
                        "oneOf": [
                            {
                                "type": "null"
                            },
                            {
                                "$ref": "#/components/schemas/PublicContentType"
                            }
                        ]
                    },
                    "mode": {
                        "oneOf": [
                            {
                                "type": "null"
                            },
                            {
                                "$ref": "#/components/schemas/PublicPolicyMode"
                            }
                        ]
                    },
                    "deployment_ids": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "severity_level_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "uuid"
                    },
                    "country_codes": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "rollout_percentage": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "format": "int32"
                    }
                }
            },
            "CreateUserStrikeAppealRequest": {
                "type": "object",
                "required": [
                    "reason"
                ],
                "properties": {
                    "reason": {
                        "type": "string"
                    },
                    "session_id": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "strike_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "uuid"
                    }
                }
            },
            "CreateUserStrikeAppealResponse": {
                "type": "object",
                "required": [
                    "appeal_id",
                    "status"
                ],
                "properties": {
                    "appeal_id": {
                        "type": "string"
                    },
                    "status": {
                        "type": "string"
                    }
                }
            },
            "CreateUserStrikeRequest": {
                "type": "object",
                "required": [
                    "policy_id",
                    "severity_level_id"
                ],
                "properties": {
                    "email": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "external_session_id": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "id": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "internal_session_id": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "ip": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "policy_id": {
                        "type": "string"
                    },
                    "severity_level_id": {
                        "type": "string",
                        "format": "uuid"
                    }
                }
            },
            "CreateUserStrikeResponse": {
                "type": "object",
                "required": [
                    "strike"
                ],
                "properties": {
                    "action": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "action_expires_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "strike": {
                        "$ref": "#/components/schemas/PublicStrikeItem"
                    }
                }
            },
            "DeletePolicyPublicRequest": {
                "type": "object",
                "required": [
                    "id"
                ],
                "properties": {
                    "id": {
                        "type": "string"
                    }
                }
            },
            "GetByIdQueryV3": {
                "type": "object",
                "properties": {
                    "deployment_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Optional deployment ID to validate session ownership"
                    },
                    "external_session_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Find check results by external session ID (your tracking identifier)"
                    },
                    "internal_session_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Find check results by internal session ID (system-generated UUID)"
                    }
                }
            },
            "GetByIdResponseV3": {
                "type": "object",
                "required": [
                    "list"
                ],
                "properties": {
                    "list": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/CheckResponseV3"
                        }
                    }
                },
                "example": {
                    "list": [
                        {
                            "flagged": true,
                            "internal_session_id": "123e4567-e89b-12d3-a456-426614174000",
                            "external_session_id": "user-session-001",
                            "policies": {
                                "70289e06-9111-463e-b121-7247c2b7bfbd": {
                                    "flagged": true,
                                    "flagged_source": [
                                        "text"
                                    ],
                                    "name": "No PII Sharing"
                                }
                            }
                        }
                    ]
                }
            },
            "IndexMap": {
                "type": "object",
                "additionalProperties": {
                    "type": "object",
                    "additionalProperties": {
                        "oneOf": [
                            {
                                "type": "string"
                            },
                            {
                                "type": "number",
                                "format": "double"
                            },
                            {
                                "type": "boolean"
                            }
                        ]
                    },
                    "propertyNames": {
                        "type": "string"
                    }
                },
                "propertyNames": {
                    "type": "string"
                }
            },
            "MessageInfoV3": {
                "type": "object",
                "properties": {
                    "id": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "timestamp": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                }
            },
            "MessageMetadataV3": {
                "type": "object",
                "properties": {
                    "assistant": {
                        "oneOf": [
                            {
                                "type": "null"
                            },
                            {
                                "$ref": "#/components/schemas/AssistantInfoV3"
                            }
                        ]
                    },
                    "message": {
                        "oneOf": [
                            {
                                "type": "null"
                            },
                            {
                                "$ref": "#/components/schemas/MessageInfoV3"
                            }
                        ]
                    },
                    "user": {
                        "oneOf": [
                            {
                                "type": "null"
                            },
                            {
                                "$ref": "#/components/schemas/UserInfoV3"
                            }
                        ]
                    }
                }
            },
            "PolicyStatusV3": {
                "type": "object",
                "required": [
                    "flagged",
                    "flagged_source",
                    "name"
                ],
                "properties": {
                    "flagged": {
                        "type": "boolean"
                    },
                    "flagged_source": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/ViolationSource"
                        }
                    },
                    "name": {
                        "type": "string"
                    }
                }
            },
            "PublicAppliesTo": {
                "type": "string",
                "enum": [
                    "input",
                    "output",
                    "any"
                ],
                "example": "input"
            },
            "PublicContentType": {
                "type": "string",
                "enum": [
                    "session",
                    "artifact",
                    "any"
                ],
                "example": "session"
            },
            "PublicPolicy": {
                "type": "object",
                "required": [
                    "id",
                    "name",
                    "flagged_content",
                    "content_type",
                    "applies_to",
                    "mode",
                    "rollout_percentage",
                    "revision_id",
                    "created_at",
                    "deployment_ids",
                    "country_codes"
                ],
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "allowed_content": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "flagged_content": {
                        "type": "string"
                    },
                    "applies_to": {
                        "$ref": "#/components/schemas/PublicAppliesTo"
                    },
                    "content_type": {
                        "$ref": "#/components/schemas/PublicContentType"
                    },
                    "mode": {
                        "$ref": "#/components/schemas/PublicPolicyMode"
                    },
                    "severity_level_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "uuid"
                    },
                    "deployment_ids": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "country_codes": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "rollout_percentage": {
                        "type": "integer",
                        "format": "int32",
                        "minimum": 0
                    },
                    "revision_id": {
                        "type": "string"
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time"
                    },
                    "deleted_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    }
                }
            },
            "PublicPolicyMode": {
                "type": "string",
                "enum": [
                    "prod",
                    "shadow"
                ],
                "example": "prod"
            },
            "PublicStrikeAppeal": {
                "type": "object",
                "required": [
                    "time",
                    "status"
                ],
                "properties": {
                    "status": {
                        "type": "string"
                    },
                    "time": {
                        "type": "integer",
                        "format": "int64"
                    }
                }
            },
            "PublicStrikeItem": {
                "type": "object",
                "required": [
                    "severity",
                    "points",
                    "created_at",
                    "expires_at",
                    "reason",
                    "internal_session_id",
                    "policy"
                ],
                "properties": {
                    "appeal": {
                        "oneOf": [
                            {
                                "type": "null"
                            },
                            {
                                "$ref": "#/components/schemas/PublicStrikeAppeal"
                            }
                        ]
                    },
                    "created_at": {
                        "type": "integer",
                        "format": "int64"
                    },
                    "expires_at": {
                        "type": "integer",
                        "format": "int64"
                    },
                    "external_session_id": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "internal_session_id": {
                        "type": "string"
                    },
                    "points": {
                        "type": "integer",
                        "format": "int32"
                    },
                    "policy": {
                        "$ref": "#/components/schemas/PublicStrikePolicy"
                    },
                    "reason": {
                        "type": "string"
                    },
                    "severity": {
                        "type": "string"
                    }
                }
            },
            "PublicStrikePolicy": {
                "type": "object",
                "required": [
                    "id",
                    "name",
                    "severity"
                ],
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "name": {
                        "type": "string"
                    },
                    "severity": {
                        "type": "string"
                    }
                }
            },
            "RequestChatContent": {
                "oneOf": [
                    {
                        "type": "string"
                    },
                    {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/RequestContentPart"
                        }
                    }
                ]
            },
            "RequestChatMessageV3": {
                "type": "object",
                "required": [
                    "role"
                ],
                "properties": {
                    "content": {
                        "oneOf": [
                            {
                                "type": "null"
                            },
                            {
                                "$ref": "#/components/schemas/RequestChatContent"
                            }
                        ]
                    },
                    "metadata": {
                        "oneOf": [
                            {
                                "type": "null"
                            },
                            {
                                "$ref": "#/components/schemas/MessageMetadataV3"
                            }
                        ]
                    },
                    "role": {
                        "type": "string"
                    }
                }
            },
            "RequestChatRole": {
                "type": "string",
                "enum": [
                    "system",
                    "assistant",
                    "user",
                    "tool",
                    "developer"
                ]
            },
            "RequestContentPart": {
                "oneOf": [
                    {
                        "type": "object",
                        "required": [
                            "text",
                            "type"
                        ],
                        "properties": {
                            "text": {
                                "type": "string"
                            },
                            "type": {
                                "type": "string",
                                "enum": [
                                    "text"
                                ]
                            }
                        }
                    },
                    {
                        "type": "object",
                        "required": [
                            "text",
                            "type"
                        ],
                        "properties": {
                            "text": {
                                "type": "string"
                            },
                            "type": {
                                "type": "string",
                                "enum": [
                                    "input_text"
                                ]
                            }
                        }
                    },
                    {
                        "type": "object",
                        "required": [
                            "type"
                        ],
                        "properties": {
                            "internal_artifact_id": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "content": {
                                "oneOf": [
                                    {
                                        "type": "null"
                                    },
                                    {
                                        "$ref": "#/components/schemas/ArtifactContent"
                                    }
                                ]
                            },
                            "external_artifact_id": {
                                "type": [
                                    "string",
                                    "null"
                                ]
                            },
                            "type": {
                                "type": "string",
                                "enum": [
                                    "artifact"
                                ]
                            }
                        }
                    }
                ]
            },
            "RiskLevel": {
                "type": "string",
                "enum": [
                    "normal",
                    "elevated",
                    "severe"
                ]
            },
            "UpdatePolicyRequest": {
                "type": "object",
                "required": [
                    "id"
                ],
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "name": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "allowed_content": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "flagged_content": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "applies_to": {
                        "oneOf": [
                            {
                                "type": "null"
                            },
                            {
                                "$ref": "#/components/schemas/PublicAppliesTo"
                            }
                        ]
                    },
                    "content_type": {
                        "oneOf": [
                            {
                                "type": "null"
                            },
                            {
                                "$ref": "#/components/schemas/PublicContentType"
                            }
                        ]
                    },
                    "mode": {
                        "oneOf": [
                            {
                                "type": "null"
                            },
                            {
                                "$ref": "#/components/schemas/PublicPolicyMode"
                            }
                        ]
                    },
                    "deployment_ids": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "severity_level_id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "uuid"
                    },
                    "country_codes": {
                        "type": [
                            "array",
                            "null"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "rollout_percentage": {
                        "type": [
                            "integer",
                            "null"
                        ],
                        "format": "int32"
                    }
                }
            },
            "UserInfoV3": {
                "type": "object",
                "properties": {
                    "city": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "City name",
                        "example": "San Francisco"
                    },
                    "country": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Full country name",
                        "example": "United States"
                    },
                    "country_code": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "ISO 3166-1 alpha-2 country code (e.g., 'US', 'GB')",
                        "example": "US"
                    },
                    "email": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "id": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "ip": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "User's IP address for geolocation lookup",
                        "example": "8.8.8.8"
                    },
                    "latitude": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "format": "double",
                        "description": "Latitude coordinate",
                        "example": 37.7749
                    },
                    "longitude": {
                        "type": [
                            "number",
                            "null"
                        ],
                        "format": "double",
                        "description": "Longitude coordinate",
                        "example": -122.4194
                    },
                    "name": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "state": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "State/province name or code",
                        "example": "California"
                    }
                }
            },
            "UserRiskQuery": {
                "type": "object",
                "properties": {
                    "email": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "User email address (provide exactly one of email, id, or ip)"
                    },
                    "id": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "External user ID (provide exactly one of email, id, or ip)"
                    },
                    "ip": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "User IP address (provide exactly one of email, id, or ip)"
                    }
                }
            },
            "UserRiskResponse": {
                "type": "object",
                "required": [
                    "total_strike_points",
                    "strikes"
                ],
                "properties": {
                    "action": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "action_expires_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date-time"
                    },
                    "strikes": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/PublicStrikeItem"
                        }
                    },
                    "total_strike_points": {
                        "type": "integer",
                        "format": "int32"
                    }
                },
                "example": {
                    "action": null,
                    "action_expires_at": null,
                    "strikes": [],
                    "total_strike_points": 0
                }
            },
            "UserStrikeAppealResponse": {
                "type": "object",
                "required": [
                    "appeal_id",
                    "status",
                    "current_points"
                ],
                "properties": {
                    "appeal_id": {
                        "type": "string"
                    },
                    "current_level": {
                        "type": [
                            "string",
                            "null"
                        ]
                    },
                    "current_points": {
                        "type": "integer",
                        "format": "int32"
                    },
                    "status": {
                        "type": "string"
                    },
                    "updated_by": {
                        "type": [
                            "string",
                            "null"
                        ]
                    }
                }
            },
            "ViolationSource": {
                "type": "string",
                "enum": [
                    "text",
                    "image"
                ]
            }
        },
        "securitySchemes": {
            "bearerAuth": {
                "type": "http",
                "scheme": "bearer",
                "bearerFormat": "API Key",
                "description": "API Key required. Format: Bearer wc-your-api-key"
            }
        }
    },
    "tags": [
        {
            "name": "Session",
            "description": "Session-based content checking and moderation"
        },
        {
            "name": "User",
            "description": "User risk assessment and scoring"
        },
        {
            "name": "Policy",
            "description": "Policy management CRUD"
        },
        {
            "name": "Metric",
            "description": "Metric management CRUD"
        },
        {
            "name": "Artifact",
            "description": "Standalone artifact moderation"
        }
    ]
}
