> ## Documentation Index
> Fetch the complete documentation index at: https://mako-docs.devinagiffy.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Flags Overview

> Understanding wellbeing flags in Hitler

## What Are Flags?

Flags are system-detected concerns that indicate an employee may need support. They're raised automatically based on patterns in:

* Mood entries (consistently low)
* Task completion (declining)
* Engagement patterns (reduced activity)

## Flag Severity

| Level    | Color     | Response Time |
| -------- | --------- | ------------- |
| Low      | 🟡 Yellow | Monitor       |
| Medium   | 🟠 Orange | 1 week        |
| High     | 🔴 Red    | 1-2 days      |
| Critical | ⚫ Black   | Immediate     |

## Flag Lifecycle

```mermaid theme={null}
graph LR
    A[Detected] --> B[Active]
    B -->|Manager action| C[Resolved]
    C -->|New concern| B
```

## Privacy

<Warning>
  Flags alert managers that support may be needed, but **never reveal specific mood scores or
  journal entries**.
</Warning>

Flag information includes:

* Severity level
* General reason (e.g., "declining mood trend")
* Recommended actions

Flag information does NOT include:

* Specific mood values
* Journal content
* Detailed task data

## Endpoints

| Method | Endpoint                | Description            | Role     |
| ------ | ----------------------- | ---------------------- | -------- |
| GET    | `/flags`                | Get my flags           | Any      |
| GET    | `/flags/organization`   | Get org flags          | Manager+ |
| GET    | `/flags/:id`            | Get flag details       | Any      |
| PATCH  | `/flags/:id/resolve`    | Resolve flag           | Manager+ |
| PATCH  | `/flags/:id/reopen`     | Reopen flag            | Manager+ |
| GET    | `/flags/:id/escalation` | Get escalation actions | Any      |

## Inquiries

Related to flags, **inquiries** allow private communication:

| Method | Endpoint                        | Description        |
| ------ | ------------------------------- | ------------------ |
| GET    | `/flags/inquiries`              | List my inquiries  |
| POST   | `/flags/inquiries`              | Create inquiry     |
| GET    | `/flags/inquiries/:id`          | Get inquiry thread |
| POST   | `/flags/inquiries/:id/messages` | Add message        |
| PATCH  | `/flags/inquiries/:id/close`    | Close inquiry      |