API Referenceautomations

Conditions Partial Update 2

PATCH handler with superadmin lock and field protection.

Checks:

  1. Object lock (is_managed=True -> non-superadmins can’t modify)
  2. Field protection (non-superadmins can’t modify specific fields)

Authentication

AuthorizationBearer
JWT access token or Respan API key

Path parameters

condition_idstringRequired

Request

This endpoint expects an object.
idstringOptional1-255 characters
unique_organization_idstringOptional1-255 characters
Organization identifier
namestringOptional1-255 characters

Human-readable name for the condition

descriptionstringOptional
Description of what this condition does
condition_policyanyOptional
Complex condition rules and logic stored as JSON
filter_set_idstring or nullOptional<=255 characters
Filter set identifier for log filtering
time_step_minutesinteger or nullOptional-2147483648-2147483647
Time window in minutes for aggregation type conditions
sampling_ratedouble or nullOptional

Sampling rate for single log conditions (0.0 to 1.0)

updated_byinteger or nullOptional

Response

unique_organization_idstring<=255 characters
Organization identifier
namestring<=255 characters

Human-readable name for the condition

condition_policyany
Complex condition rules and logic stored as JSON
created_atdatetimeRead-only
updated_atdatetimeRead-only
idstring<=255 characters
descriptionstring
Description of what this condition does
filter_set_idstring or null<=255 characters
Filter set identifier for log filtering
time_step_minutesinteger or null-2147483648-2147483647
Time window in minutes for aggregation type conditions
sampling_ratedouble or null

Sampling rate for single log conditions (0.0 to 1.0)

updated_byinteger or null