> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aient.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# problem.detected

> CloudEvent fired when Aient detects a new problem from grouped telemetry, with payload fields organisationId, problemId, environmentId, severity, and title.

# ai.aient.problem.detected

> Generated from `@aient/events`. Do not edit this page by hand.

A new problem was detected.

## Delivery Contract

| Field            | Value                                                                   |
| ---------------- | ----------------------------------------------------------------------- |
| Visibility       | Tenant-selectable public event                                          |
| Topic            | `v1.events.problems`                                                    |
| Bounded context  | `problem`                                                               |
| Source           | `https://aient.ai/api/organisations/{organisationId}`                   |
| Subject          | `problems/{problemId}`                                                  |
| Schema ID        | `sch_01J8X7AKZP4N6QHF2T1Y3R5VB9`                                        |
| Immutable schema | `https://registry.aient.ai/schemas/sch_01J8X7AKZP4N6QHF2T1Y3R5VB9.json` |
| Version alias    | `https://registry.aient.ai/events/ai.aient.problem.detected/v1.json`    |

## Payload Fields

| Field            | Required | Type     | Enum                                |
| ---------------- | -------- | -------- | ----------------------------------- |
| `environmentId`  | no       | `string` | -                                   |
| `organisationId` | yes      | `string` | -                                   |
| `problemId`      | yes      | `string` | -                                   |
| `severity`       | no       | `string` | `critical`, `high`, `medium`, `low` |
| `title`          | yes      | `string` | -                                   |

## Privacy Notes

ID-first customer-facing payload. Do not include secrets, tokens, raw telemetry, prompts, logs, or customer content.

## Lifecycle Notes

Emitted after the owning bounded-context state transition commits through its Restate handler.

## Compatibility Notes

Backward-compatible schema changes may add optional fields; removing fields, changing field types, or removing enum values requires a new schema revision and migration plan.

## Example CloudEvent

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": {
    "environmentId": "environment_example",
    "organisationId": "11111111-1111-4111-8111-111111111111",
    "problemId": "problem_example",
    "severity": "critical",
    "title": "Example problem"
  },
  "datacontenttype": "application/json",
  "dataschema": "https://registry.aient.ai/schemas/sch_01J8X7AKZP4N6QHF2T1Y3R5VB9.json",
  "id": "evt_01J8X7AKZP4N6QHF2T1Y3R5VAA",
  "organisationid": "11111111-1111-4111-8111-111111111111",
  "source": "https://aient.ai/api/organisations/11111111-1111-4111-8111-111111111111",
  "specversion": "1.0",
  "subject": "problems/problem_example",
  "time": "2026-04-25T12:00:00.000Z",
  "type": "ai.aient.problem.detected"
}
```