Skip to main content
POST
/
governance
/
signals
/
{signal_id}
/
acknowledge
Acknowledge a governance signal
curl --request POST \
  --url https://api.mnemom.ai/v1/governance/signals/{signal_id}/acknowledge \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "action_taken": "<string>"
}
'
{
  "id": "<string>",
  "scope_id": "<string>",
  "pattern_type": "<string>",
  "detected_at": "2023-11-07T05:31:56Z",
  "detected_by": "<string>",
  "org_id": "<string>",
  "agent_ids": [
    "<string>"
  ],
  "detail": {},
  "source_ref": {},
  "notification_state": {
    "skipped": true
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "team_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "acknowledged_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "acknowledged_at": "2023-11-07T05:31:56Z",
  "action_taken": "<string>",
  "resolved_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "resolved_at": "2023-11-07T05:31:56Z",
  "expires_at": "2023-11-07T05:31:56Z",
  "webhook_delivery_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

​
Authorization
string
header
required

Supabase JWT token in Authorization: Bearer header

Path Parameters

​
signal_id
string
required
Pattern: ^gs-[0-9a-f]{12}$

Body

application/json
​
action_taken
string

Optional note about what action is being taken.

Response

Governance signal.

A governance signal row — operator-actionable observation per ADR-048.

​
id
string
required
Pattern: ^gs-[0-9a-f]{12}$
​
scope
enum<string>
required

Scope at which the signal is produced and routed (ADR-048 §1).

Available options:
platform,
org,
team,
agent
​
scope_id
string
required
​
source
enum<string>
required

Source detector for the signal. Closed enum per ADR-048 §1.

Available options:
sideband.drift,
sideband.coherence,
sideband.fault_line,
sideband.fleet
​
pattern_type
string
required

Free-form per source.

​
severity
enum<string>
required
Available options:
info,
warn,
high,
critical
​
detected_at
string<date-time>
required
​
detected_by
string
required
​
org_id
string
required
​
agent_ids
string[]
required
​
detail
object
required
​
source_ref
object
required
​
status
enum<string>
required
Available options:
open,
acknowledged,
resolved,
dismissed,
expired
​
notification_state
object
required

Per-channel dispatch state populated by the notification dispatcher.

​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
team_id
string<uuid> | null
​
acknowledged_by
string<uuid> | null
​
acknowledged_at
string<date-time> | null
​
acknowledged_actor_role
enum<string> | null

Audit-actor role per ADR-046.

Available options:
platform_admin,
org_owner,
org_admin,
team_admin,
member,
system
​
resolution_status
enum<string> | null
Available options:
action_taken,
wont_fix,
duplicate,
false_positive,
self_resolved
​
action_taken
string | null
​
resolved_by
string<uuid> | null
​
resolved_at
string<date-time> | null
​
expires_at
string<date-time> | null
​
webhook_delivery_id
string<uuid> | null