Struct NewEvent 

pub struct NewEvent {
    pub active: Option<bool>,
    pub description: Option<String>,
    pub message: String,
    pub occurred_at: Option<Timestamp>,
    pub ref_: String,
    pub severity: Option<Severity>,
    pub source: String,
}

A single occurrence to report against an issue, sent either by a device or by an operator. If an issue with the same source and ref is already open, this occurrence is folded into it (bumping its last-seen time, and coalescing into the latest recorded event when the content is identical); otherwise a new issue is created.

JSON schema

{
 "description": "A single occurrence to report against an issue, sent either by a device\nor by an operator. If an issue with the same `source` and `ref` is\nalready open, this occurrence is folded into it (bumping its last-seen\ntime, and coalescing into the latest recorded event when the content is\nidentical); otherwise a new issue is created.",
 "type": "object",
 "required": [
   "message",
   "ref",
   "source"
 ],
 "properties": {
   "active": {
     "description": "Whether the condition this event describes is still ongoing.\nDefaults to `true`. Sending `false` marks the condition as cleared,\nwhich can close the issue's contribution to any open incident.",
     "type": [
       "boolean",
       "null"
     ]
   },
   "description": {
     "description": "A short, single-line title for this event, shown as the issue's\nheadline in the UI and as the subject of any Slack notification.\nMust not contain newlines. Use `message` for the full body text.",
     "type": [
       "string",
       "null"
     ]
   },
   "message": {
     "description": "The full body text for this event. Free-form, multi-line text is\nfine. If `description` is omitted, the UI falls back to using the\nfirst line of this field as the headline.",
     "type": "string"
   },
   "occurredAt": {
     "description": "When the event actually happened, if known and different from when\nit was received. Defaults to the time the event was received.",
     "type": [
       "string",
       "null"
     ],
     "format": "date-time"
   },
   "ref": {
     "description": "A caller-chosen identifier for this specific problem within `source`,\nused to detect repeated reports of the same underlying condition.\nRequired — mint a UUID if deduplication isn't needed.",
     "type": "string"
   },
   "severity": {
     "oneOf": [
       {
         "type": "null"
       },
       {
         "description": "Severity of this event. Defaults to a standard severity if omitted.",
         "$ref": "#/components/schemas/Severity"
       }
     ]
   },
   "source": {
     "description": "Identifies what is reporting this event — a healthcheck, a backup\npipeline, an operator, etc.",
     "type": "string"
   }
 }
}

Fields

active: Option<bool>

Whether the condition this event describes is still ongoing. Defaults to true. Sending false marks the condition as cleared, which can close the issue’s contribution to any open incident.

description: Option<String>

A short, single-line title for this event, shown as the issue’s headline in the UI and as the subject of any Slack notification. Must not contain newlines. Use message for the full body text.

message: String

The full body text for this event. Free-form, multi-line text is fine. If description is omitted, the UI falls back to using the first line of this field as the headline.

occurred_at: Option<Timestamp>

When the event actually happened, if known and different from when it was received. Defaults to the time the event was received.

ref_: String

A caller-chosen identifier for this specific problem within source, used to detect repeated reports of the same underlying condition. Required — mint a UUID if deduplication isn’t needed.

severity: Option<Severity>

source: String

Identifies what is reporting this event — a healthcheck, a backup pipeline, an operator, etc.

Trait Implementations

impl Clone for NewEvent

fn clone(&self) -> NewEvent

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NewEvent

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for NewEvent

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for NewEvent

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.