AttentionSignal
/api/v1/common/attention-signalsAn explainable "why now" signal flagging an entity that needs attention.
listgetcreateupdatedeletedismissresolveSchema
| Field | Type | Notes |
|---|---|---|
| id* | uuid | Server-assigned ULID with type prefix (e.g. per_…). |
| tenant_id* | string | Tenant scope — auto-stamped from the caller's JWT. |
| app_id | string | App scope. Stamped ONLY when the caller's JWT was minted for a specific Application (integration API keys). Absent for human-user sessions. Filters reads when present. |
| created_at* | date-time | Server stamp. |
| updated_at* | date-time | Server stamp; updated on every patch. |
| created_by | uuid | Person id from the caller's JWT (sub). |
| updated_by | uuid | Person id from the last writer's JWT (sub). |
| source | string | Provenance tag — defaults to 'edm'. |
| source_type | enum | frontend | backend | server | system | apiWhere the write originated. Defaults to 'api'. |
| is_deleted | boolean | Soft-delete flag. Excluded from default list queries. |
| deleted_at | date-time | Stamped when soft-deleted; null otherwise. |
| deleted_by | uuid | Person id who soft-deleted; null otherwise. |
| schema_version | number | Document schema version. Bumped on incompatible writes. |
| target_id* | string | ID of the entity needing attention (account, project, task, etc.). |
| target_type* | enum | account | project | task | incident | approval | contract | lead | deal | case | policy | risk | asset | employee | otherType of target entity. |
| domain* | enum | work | service | legal | marketing | finance | hr | compliance | operations | security | customer | otherBusiness domain this signal belongs to. |
| signal_type* | enum | sla_risk | overdue_approval | stale_owner | renewal_risk | missing_evidence | contract_due | deadline_approaching | blocked | escalation | anomaly | follow_up | review_due | otherType of attention signal. |
| severity* | enum | critical | high | medium | lowSignal severity level. |
| reason* | string | Human-readable explanation of why attention is needed. |
| summary | string | Brief summary for list views. |
| due_at | date-time | When this becomes urgent/deadline. |
| stale_at | date-time | When this becomes stale if not addressed. |
| owner_id | string | User who should act on this signal. |
| team_id | string | Team responsible for this signal. |
| source_refs | json | Array of source records that generated this signal. |
| computed_by | string | System or user that computed this signal. |
| status | enum | active | dismissed | resolved | expiredSignal lifecycle status. |
| dismissed_at | date-time | When signal was dismissed. |
| dismissed_by | string | Who dismissed the signal. |
| resolved_at | date-time | When signal was resolved. |
| resolved_by | string | Who resolved the signal. |
| resolution_notes | string | Notes about how the signal was resolved. |
| metadata | json | Additional context-specific data. |
| tags | json | Free-form tags. |
API
Loading manifest…