Create Ruleset

Create a new ruleset in the incident management system by submitting a configuration payload in the request body. The ruleset defines the logic for automatically generating incidents when specific conditions are met.

Required fields typically include the type of rule (e.g., state-change), an array of conditions, the target team_id or assignees, urgency level, and a descriptive name and description for context.

Once created, this ruleset becomes active and will automatically evaluate incoming events according to the defined logic.

Use cases:

• Proactive alerting — Define custom logic to convert alert data into actionable incidents automatically.
• Team-based triage — Assign rules to specific teams to ensure incidents are routed to the right responders based on the rule's criteria.
• Flexible escalation logic — Configure different urgency levels and descriptions depending on the nature of the matched condition.

To review existing rules, see Get Rulesets.
To delete an existing rule, use Delete Ruleset.

Authorization: Bearer YOUR_TOKEN

Expected Behavior:

• On success, the system will create a new ruleset and return the ruleset ID.
• If the request is invalid, the system will return an error message with details of the invalid fields.