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
Privacy
Flags alert managers that support may be needed, but never reveal specific mood scores or
journal entries.
- 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 |
