# Create discover

URL: https://docs.hanzo.ai/docs/openapi/o11y/post-o11y-sentinel-discover

> Aggregates a project's captured errors into a table — the caller names the filters, the groupings and the aggregations, and gets back the columns and rows they asked for.

`POST /v1/o11y/sentinel/discover`

> [O11y →](https://docs.hanzo.ai/docs/openapi/o11y) · [All API references →](https://docs.hanzo.ai/docs/openapi) · [Get started →](https://docs.hanzo.ai/docs/guides)

|               |                                                  |
| ------------- | ------------------------------------------------ |
| **Address**   | `https://api.hanzo.ai/v1/o11y/sentinel/discover` |
| **Method**    | `POST`                                           |
| **Operation** | `post_o11y_sentinel_discover`                    |
| **Auth**      | `Authorization: Bearer $HANZO_API_KEY`           |

Aggregates a project's captured errors into a table — the caller
names the filters, the groupings and the aggregations, and gets back the
columns and rows they asked for.

The project is mandatory and is checked against the caller's own org before it
scopes anything, so a project id belonging to someone else reads as absent
rather than as data.

## Request

11 fields, body `application/json` (required).

| Field             | In   | Type               | Required | Description                                                                                                   |
| ----------------- | ---- | ------------------ | -------- | ------------------------------------------------------------------------------------------------------------- |
| `aggregations`    | body | string\[]          | —        | Aggregations are the measures to compute per group.                                                           |
| `filters`         | body | o11y.O11yFilter\[] | —        | Filters narrow the scan; each is a field, an operator (eq, neq, like) and a value, and they combine with AND. |
| `filters[].field` | body | string             | —        | Field is the column to test.                                                                                  |
| `filters[].op`    | body | string             | —        | Op is how to test it: eq, neq or like.                                                                        |
| `filters[].value` | body | string             | —        | Value is what to test it against.                                                                             |
| `groupBy`         | body | string\[]          | —        | GroupBy are the columns to group the rows by.                                                                 |
| `limit`           | body | integer (int64)    | —        | Limit caps how many rows come back.                                                                           |
| `orderBy`         | body | string             | —        | OrderBy is the column or aggregation to sort the rows on.                                                     |
| `orderDir`        | body | string             | —        | OrderDir is asc or desc.                                                                                      |
| `period`          | body | string             | —        | Period is the window to read, relative to now — 1h, 24h, 7d, 14d, 30d.                                        |
| `project`         | body | string             | yes      | Project is the project to read, as its id.                                                                    |

## Response

| Status    | Body                 | Meaning           |
| --------- | -------------------- | ----------------- |
| `200`     | o11y.O11yDiscoverOut | ok                |
| `202`     | Approval             | held for approval |
| `default` | problem-details      | refused           |

`200` body — 4 fields.

| Field          | In   | Type           | Always | Description                                        |
| -------------- | ---- | -------------- | ------ | -------------------------------------------------- |
| `data`         | body | o11y.O11yTable | —      |                                                    |
| `data.columns` | body | string\[]      | —      | Columns names each position in a row.              |
| `data.rows`    | body | any\[]\[]      | —      | Rows are the result rows, each as long as Columns. |
| `status`       | body | string         | —      | Status is "success".                               |

Failure carries the platform error shape — see [Errors](https://docs.hanzo.ai/docs/errors).

## Examples

**CLI**

```bash
hanzo o11y sentinel discover --project <project>
```

**SDK**

**.ts**

```ts
import { Configuration, O11yApi } from 'hanzoai';

const api = new O11yApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.postO11ySentinelDiscover({ project: "<project>" });
```

**.py**

```python
from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import O11yApi

client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = O11yApi(client).post_o11y_sentinel_discover(project="<project>")
```

**.go**

```go
cfg := hanzoai.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := hanzoai.NewAPIClient(cfg)

resp, _, err := client.O11yAPI.PostO11ySentinelDiscover(context.Background()).Execute()
if err != nil {
	return err
}
```

**.rs**

```rust
use hanzo_client::apis::{configuration::Configuration, o11y_api};

let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();

let result = o11y_api::post_o11y_sentinel_discover(&cfg, Default::default()).await?;
```

**.java**

```java
import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.O11yApi;

ApiClient client = new ApiClient();
client.setBearerToken(System.getenv("HANZO_API_KEY"));

var result = new O11yApi(client).postO11ySentinelDiscover();
```

**HTTP**

```bash
curl -X POST https://api.hanzo.ai/v1/o11y/sentinel/discover \
  -H "Authorization: Bearer $HANZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
       "project": "<project>"
     }'
```

**MCP**

MCP reaches **o11y** through the `o11y` tool, which names its 307 operations with its own verbs — this one among them, under a name only MCP declares. `describe` explains any of them:

```bash
curl -X POST https://api.hanzo.ai/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/call",
       "params": {
         "name": "describe",
         "arguments": {
           "op": "list_o11y_autocomplete_aggregate_attributes"
         }
       }
     }'
```

---

[O11y API](https://docs.hanzo.ai/docs/openapi/o11y) · [All Hanzo APIs](https://docs.hanzo.ai/docs/openapi) · [Interactive reference](https://docs.hanzo.ai/docs/openapi/reference)