# cloud.pyroclastic.status.incident

> Published by [ops.dids.lol](https://lexicon.garden/identity/did:plc:qnyj44s7iujxusfvc574dfwm)

✓ This is the authoritative definition for this NSID.

## Description

A pyroclastic.cloud incident. This lexicon is 'community.lexicon.calendar.event'-like.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:qnyj44s7iujxusfvc574dfwm/cloud.pyroclastic.status.incident)
- [Documentation](https://lexicon.garden/lexicon/did:plc:qnyj44s7iujxusfvc574dfwm/cloud.pyroclastic.status.incident/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:qnyj44s7iujxusfvc574dfwm/cloud.pyroclastic.status.incident/examples)

## Definitions

### `cloud.pyroclastic.status.incident`

**Type**: `record`

The key of the incident.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `components` | `array` | No | What the incident affects, as component records. |
| `createdAt` | `string` (datetime) | Yes | When the incident is opened. |
| `description` | `string` | No | Additional details and information about the incident. |
| `endsAt` | `string` (datetime) | No | When the incident ended. Absent implies it is ongoing unless otherwise noted. |
| `name` | `string` | Yes | A brief one-line summary of what is wrong. |
| `severity` | `string` | Yes | The severity of the incident |
| `startsAt` | `string` (datetime) | Yes | When the incident started, or was first observed or reported. |
| `updates` | `array` | Yes | The incident timeline. |

### `cloud.pyroclastic.status.incident#update`

**Type**: `object`

One entry in an incident's timeline.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `at` | `string` (datetime) | Yes | The time of the update. |
| `status` | `string` | Yes | The incident's status as of this update. |
| `text` | `string` | Yes | The update relevant to the incident. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "The key of the incident.",
      "key": "tid",
      "record": {
        "properties": {
          "components": {
            "description": "What the incident affects, as component records.",
            "items": {
              "ref": "com.atproto.repo.strongRef",
              "type": "ref"
            },
            "maxLength": 32,
            "type": "array"
          },
          "createdAt": {
            "description": "When the incident is opened.",
            "format": "datetime",
            "type": "string"
          },
          "description": {
            "description": "Additional details and information about the incident.",
            "maxGraphemes": 1000,
            "maxLength": 3000,
            "type": "string"
          },
          "endsAt": {
            "description": "When the incident ended. Absent implies it is ongoing unless otherwise noted.",
            "format": "datetime",
            "type": "string"
          },
          "name": {
            "description": "A brief one-line summary of what is wrong.",
            "maxGraphemes": 64,
            "maxLength": 640,
            "type": "string"
          },
          "severity": {
            "description": "The severity of the incident",
            "knownValues": [
              "minor",
              "major"
            ],
            "maxLength": 64,
            "type": "string"
          },
          "startsAt": {
            "description": "When the incident started, or was first observed or reported.",
            "format": "datetime",
            "type": "string"
          },
          "updates": {
            "description": "The incident timeline.",
            "items": {
              "ref": "#update",
              "type": "ref"
            },
            "maxLength": 128,
            "minLength": 1,
            "type": "array"
          }
        },
        "required": [
          "name",
          "severity",
          "startsAt",
          "updates",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    },
    "update": {
      "description": "One entry in an incident's timeline.",
      "properties": {
        "at": {
          "description": "The time of the update.",
          "format": "datetime",
          "type": "string"
        },
        "status": {
          "description": "The incident's status as of this update.",
          "knownValues": [
            "reported",
            "investigating",
            "mitigated",
            "resolved"
          ],
          "maxLength": 64,
          "type": "string"
        },
        "text": {
          "description": "The update relevant to the incident.",
          "maxGraphemes": 1000,
          "maxLength": 3000,
          "type": "string"
        }
      },
      "required": [
        "at",
        "status",
        "text"
      ],
      "type": "object"
    }
  },
  "description": "A pyroclastic.cloud incident. This lexicon is 'community.lexicon.calendar.event'-like.",
  "id": "cloud.pyroclastic.status.incident",
  "lexicon": 1
}
```