> ## 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.

# instrumentation.discovery_started

> Webhook schema for ai.aient.instrumentation.discovery_started

# ai.aient.instrumentation.discovery\_started

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

Instrumentation discovery started for an organisation or repository.

## Delivery Contract

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

## Payload Fields

| Field                | Required | Type     | Enum |
| -------------------- | -------- | -------- | ---- |
| `agentRole`          | no       | `string` | -    |
| `organisationId`     | yes      | `string` | -    |
| `repositoryFullName` | no       | `string` | -    |
| `repositoryId`       | no       | `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": {
    "agentRole": "example-agentRole",
    "organisationId": "11111111-1111-4111-8111-111111111111",
    "repositoryFullName": "aient/example",
    "repositoryId": "repository_example"
  },
  "datacontenttype": "application/json",
  "dataschema": "https://registry.aient.ai/schemas/sch_01KREWXD59TKP6P4YZBR6ZSDH9.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": "instrumentation/discovery",
  "time": "2026-04-25T12:00:00.000Z",
  "type": "ai.aient.instrumentation.discovery_started"
}
```