Skip to main content
POST
cURL
Update a Condition by ID. Each update creates a new immutable revision.
This endpoint is available only in API version 2026-06-01. Send the whitecircle-version: 2026-06-01 header on every request.
Only the fields you provide are updated. Omit environment_ids, policy_ids, and metric_ids to preserve existing attachments; provide an empty array to clear the corresponding attachments. Set state to Active to reactivate an inactive Condition.

Authorizations

Authorization
string
header
required

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

Headers

whitecircle-version
string
required

API Version

Body

application/json
id
string<uuid>
required
name
string | null
description
string | null
conditions
any
environment_ids
string[] | null
policy_ids
string[] | null
metric_ids
string[] | null
state
null | enum<string>
Available options:
Active,
Inactive,
Draft

Response

Success

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