---
# @generated by sylphx-gen 0.1.0 from contracts@e145cc7cf1bc9605f2b27439e5e17ed76a1a2fd7e7021906a013f7565e4a0cd5. Do not edit.
title: "sylphx observability error_groups"
description: "The sylphx observability error_groups commands of Sylphx Observability: every verb, with its argument, its flags and a run line."
type: reference
product: monitoring
summary: "Every sylphx observability error_groups command: its argument, its flags and a run line."
updated: 2026-09-28
nav: false
---

The `error_groups` commands of Sylphx Observability, as the CLI spells them: the same
calls as [the `error_groups` API page](/docs/api/error_groups), typed for the
shell. [Install, sign in and the grammar](/docs/cli) are on the CLI index.

## get

Gets an error group.

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx observability error-groups get orgs/acme/projects/shop/envs/production/error_groups/error-group
```

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/error_groups/error-group` · scope `observability:read` · effect `read` · [Request, response and examples](/docs/api/error_groups/get)

## list

Lists error groups; filter by `state`, `service_name`, and `last_seen_time`.

**`PARENT`** — optional: the CLI fills it from the linked project or the
key's scope when it is left out.

**CLI**

```bash
sylphx observability error-groups list orgs/acme/projects/shop/envs/production
```

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/error_groups` · scope `observability:read` · effect `read` · [Request, response and examples](/docs/api/error_groups/list)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--page-size` | `int` | At most this many; default 50, clamped to 1000. |
| `--page-token` | `string` | `next_page_token` of the previous page. |
| `--filter` | `string` | AIP-160 filter over labels and filterable fields. |
| `--order-by` | `string` | AIP-132 ordering over filterable fields. |

## capture

Captures one error occurrence. It is grouped by `fingerprint` when the caller sets one, else by exception type and the symbolicated in-app stack; release is never part of the group. A new occurrence reopens a resolved group. Secrets and personal data are scrubbed by the environment's Scrubbing Policy before storage. A fingerprint-equal replay bills no second new-error unit. Under quota pressure the response says what to sample. Browsers call it with a publishable key that holds `observability:ingest` (CORS allowed, rate-limited per environment).

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx observability error-groups capture orgs/acme/projects/shop/envs/production
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/error_groups:capture` · scope `observability:ingest` · effect `write` · [Request, response and examples](/docs/api/error_groups/capture)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--error-event` | `json` | The occurrence; only record fields are read. Required. |

## acknowledge

Acknowledges an error group.

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx observability error-groups acknowledge orgs/acme/projects/shop/envs/production/error_groups/error-group
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/error_groups/error-group:acknowledge` · scope `observability:write` · effect `write` · [Request, response and examples](/docs/api/error_groups/acknowledge)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--etag` | `string` | Act only if the current etag matches. |

## resolve

Resolves an error group; a new occurrence reopens it.

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx observability error-groups resolve orgs/acme/projects/shop/envs/production/error_groups/error-group
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/error_groups/error-group:resolve` · scope `observability:write` · effect `write` · [Request, response and examples](/docs/api/error_groups/resolve)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--etag` | `string` | Act only if the current etag matches. |

## reopen

Reopens a resolved or acknowledged error group.

**`NAME`** — the resource's name; a bare id is enough below the linked
project.

**CLI**

```bash
sylphx observability error-groups reopen orgs/acme/projects/shop/envs/production/error_groups/error-group
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/error_groups/error-group:reopen` · scope `observability:write` · effect `write` · [Request, response and examples](/docs/api/error_groups/reopen)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--etag` | `string` | Act only if the current etag matches. |