# Create Condition

`POST /api/condition/create`

Base URLs: `https://eu.whitecircle.com`, `https://us.whitecircle.com`

OpenAPI: [latest/openapi.json](https://whitecircle.com/docs/latest/openapi.json)

Create a Condition and attach it to Environments, Policies, and Metrics.

> [!NOTE]
> This endpoint is available only in API version `2026-06-01`. Send the `whitecircle-version: 2026-06-01` header.

Use `policy_ids` for Policies and `metric_ids` for Metrics.

```json
{
  "name": "EU users",
  "description": "Apply EU-specific Policies",
  "conditions": {
    "type": "group",
    "conditions": [
      {
        "type": "condition",
        "field": "user.region",
        "operator": "eq",
        "value": "eu"
      }
    ]
  },
  "environment_ids": ["your-environment-id"],
  "policy_ids": ["policy_pii"],
  "metric_ids": ["metric_quality"],
  "state": "Active"
}
```

See [Conditions](https://whitecircle.com/docs/latest/condition/overview.md) for the expression format and runtime selection behavior.

## Authorizations

- `Authorization` (`string`, header, required): API Key required. Format: Bearer wc-your-api-key.

## Headers

- `whitecircle-version` (`string`, required): API Version. Example: `"2026-06-01"`.

## Body

`application/json`

- `name` (`string`, required)
- `description` (`string | null`, optional)
- `conditions` (`any`, optional)
- `environment_ids` (`string[] | null`, optional)
- `policy_ids` (`string[] | null`, optional)
- `metric_ids` (`string[] | null`, optional)
- `state` (`null | enum<string>`, optional): Available options: `Active`, `Inactive`, `Draft`.

## Request example

```bash
curl --request POST \
  --url 'https://eu.whitecircle.com/api/condition/create' \
  --header "Authorization: Bearer $WHITECIRCLE_API_KEY" \
  --header 'whitecircle-version: 2026-06-01' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "EU users",
  "description": "Route EU traffic to the GDPR policy set",
  "conditions": {
    "type": "condition",
    "field": "user.region",
    "operator": "eq",
    "value": "eu"
  },
  "environment_ids": [
    "environment_123"
  ],
  "policy_ids": [
    "01930000-0000-7000-8000-000000000001"
  ],
  "state": "Active"
}'
```

## Response

### 200

Success

`application/json`

- `id` (`string<uuid>`, required)
- `revision_id` (`string<uuid>`, required)
- `name` (`string`, required)
- `description` (`string`, required)
- `conditions` (`any`, required)
- `state` (`enum<string>`, required): Available options: `Active`, `Inactive`, `Draft`.
- `created_at` (`string<date-time>`, required)
- `updated_at` (`string<date-time>`, required)
- `environment_ids` (`string[]`, required)
- `policy_ids` (`string[]`, required)
- `metric_ids` (`string[]`, required)

**Example**

```json
{
  "conditions": {
    "conditions": [
      {
        "field": "user.region",
        "operator": "eq",
        "type": "condition",
        "value": "eu"
      }
    ],
    "op": "and",
    "type": "group"
  },
  "created_at": "2026-06-01T12:00:00Z",
  "description": "Applies stricter Policies to users in the EU",
  "environment_ids": [
    "117b391d-569a-4b55-8241-9f172b17a63d"
  ],
  "id": "019f0000-0000-7000-8000-000000000001",
  "metric_ids": [
    "6c0710ea-d669-49b9-9465-e52aebf95b66"
  ],
  "name": "EU users",
  "policy_ids": [
    "70289e06-9111-463e-b121-7247c2b7bfbd"
  ],
  "revision_id": "019f0000-0000-7000-8000-0000000000f1",
  "state": "Active",
  "updated_at": "2026-06-01T12:00:00Z"
}
```

### 400

Bad Request
