Skip to main content
POST
Raise or refresh a signal

Body

application/json
key
string
required

Stable condition key, e.g. host.disk.free

clearDecay
string

Judgment decay window

clearExpr
string

Probe clear expression

clearManual
boolean

Manual resolution only

clearMetric
string

Metric clear rule, e.g. free_pct>=20

clearProbe
string

Registered probe id

clearProducerResolve
boolean

Close when the producer resolves

cooldown
string

Minimum gap between surfaces

dedupeKey
string

Producer event idempotency key

detail
string

Redacted context, max 500 chars

escalateAfter
string

Age before out-of-band escalation

evidence
string

Structured observation JSON

grace
string

Clear grace window

kind
string

Producer species

maxSurfaces
string

Lifetime surface cap

recheck
string

Probe recheck interval

renotifyAfter
string

Re-surface gap after ack

reopenAfter
string

Cooldown before the key may reopen

scope
string

fleet or person|chat|project|agent:

severity
string

ambient|piggyback|nudge|interrupt|page

source
string

Producer provenance

subject
string

Entity the signal is about

targetSession
string

Comma-separated explicit target sessions

title
string

One redacted line

ttl
string

Hard lifetime

Response

Success — body conforms to the @Returns schema.

signal
object
required
status
string
required
created
boolean
suppressed
string
updated
boolean