---
title: "Create badge rule"
method: POST
path: "/api/badge-rules"
tags: ["Badge Rules"]
---

# Create badge rule

`POST /api/badge-rules`

## Request

- Base URL: `https://dregs.com`
- URL: `https://dregs.com/api/badge-rules`
- Auth: HTTP bearer

Creates a new badge rule

## Request body

- V1CreateBadgeRuleRequest
  - `name` string
  - `type` 'GOOD' | 'BAD' | 'NEUTRAL'
  - `conditions` RuleCondition[]
    - `condition` string
    - `category` string
    - `threshold` integer
    - `badge` string
    - `seconds` integer
  - `priority` integer
  - `applyDelaySeconds` integer
  - `removeDelaySeconds` integer

## Response `200`

Badge rule created

## Other responses

- `400`: Invalid request

---

[API](https://skmtc.dev/dregs/apis/dregs-api.md) · [All operations](https://skmtc.dev/dregs/apis/dregs-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dregs/apis/dregs-api/revisions/ea71f8c1eed4?raw)
