> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whitecircle.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Getting Started
> Set up text and image moderation rules for your application in minutes
export const domain = 'https://eu.whitecircle.com';
White Circle is a unified platform to protect, monitor, and improve your AI apps.
***
## Quick Start
At the core of White Circle are **policies** — written descriptions of the rules you want your content to follow.
Open the policy list page and create a new one. Specify its name, flagged content, and allowed content. These fields help you describe what exactly the policy should trigger on.
You run an online pharmacy and want to prevent your AI chatbot from giving medical advice, while still allowing it to answer questions about product availability.
In this case:
* **Flagged content:** "Providing medical advice"
* **Allowed content:** "Answering questions about the availability of medicines in the store"
Once you've filled in the details, save the policy.
Understand how policies work and best practices for defining them.
A **deployment** is a way to group policies and metrics based on your use case.
* **Age-based deployments:** Users under 18 might require stricter or dedicated CSAM policies, while adults use a different set.
* **Subscription tiers:** Premium users may have fewer restrictions than free-tier users.
* **Regional compliance:** Different deployments for different regulatory requirements.
To create a deployment, open the deployments page, click **Add Deployment**, and select the policies you want to include.
See how to organize policies into deployments for different use cases.
Navigate to your API Keys page and generate a new key.
We recommend generating separate keys for different environments (e.g., development and production), so you can revoke a specific key if needed without affecting other environments.
Your API key will have the prefix `wceu-` or `wcus-` depending on the region you're in.
You're ready to make your first API call! Use the code examples below to check content against your policies.
```bash cURL theme={null}
curl -X POST https://eu.whitecircle.com/api/session \
-H "Authorization: Bearer wc-your-api-key" \
-H "Content-Type: application/json" \
-H "whitecircle-version: 2026-04-15" \
-d '{
"deployment_id": "53e4567-e89b-12d3-a456-426614174000",
"messages": [
{
"role": "user",
"content": "Hello, can you help me with something like [some harmful question here]?"
},
{
"role": "assistant",
"content": "Of course! [Some harmful response here]"
}
]
}'
```
```python Python theme={null}
import requests
response = requests.post(
"https://eu.whitecircle.com/api/session",
headers={
"Authorization": "Bearer wc-your-api-key",
"Content-Type": "application/json",
"whitecircle-version": "2026-04-15"
},
json={
"deployment_id": "53e4567-e89b-12d3-a456-426614174000",
"messages": [
{"role": "user", "content": "Hello, can you help me with something with [some harmful question here]?"},
{"role": "assistant", "content": "Of course! [Some harmful response here]"}
]
}
)
result = response.json()
print(f"Flagged: {result['session']['flagged']}")
```
```javascript JavaScript theme={null}
const response = await fetch('https://eu.whitecircle.com/api/session', {
method: 'POST',
headers: {
'Authorization': 'Bearer wc-your-api-key',
'Content-Type': 'application/json',
'whitecircle-version': '2026-04-15'
},
body: JSON.stringify({
deployment_id: '53e4567-e89b-12d3-a456-426614174000',
messages: [
{ role: 'user', content: 'Hello, can you help me with something with [some harmful question here]?' },
{ role: 'assistant', content: 'Of course! [Some harmful response here]' }
]
})
});
const result = await response.json();
console.log(`Flagged: ${result.session.flagged}`);
```
The response will tell you if any policy violations were detected:
```json Example Response theme={null}
{
"session": {
"flagged": true,
"internal_session_id": "123e4567-e89b-12d3-a456-426614174000",
"policies": {
"70289e06-9111-463e-b121-7247c2b7bfbd": {
"flagged": false,
"flagged_source": [],
"name": "No PII Sharing"
},
"a4a91875-1e54-42d7-b9b0-a75dfebeb057": {
"flagged": true,
"flagged_source": [
"text",
"image"
],
"name": "Drugs"
}
}
},
"artifacts": []
}
```
***
## Next Steps
Learn how to define text and image moderation rules for your application.
Build product analytics for AI applications using natural language.
Group policies and metrics for different use cases.
Learn how White Circle turns policy violations into user-level actions.
Learn how to send content for moderation and analytics.