---
# @generated by sylphx-gen. Do not edit.
title: "sylphx events events"
description: "The sylphx events events commands of Sylphx Events: every verb, with its argument, its flags and a run line."
type: reference
product: queues
summary: "Every sylphx events events command: its argument, its flags and a run line."
updated: 2026-09-28
nav: false
---

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

## publish-service-event

Publishes a service's own event into a consenting tenant environment. Requires events:publish and the exact events:platform:&lt;service&gt; scope. A webhook_uri selects exactly one registered endpoint in that environment; admission atomically stores its signed, retried delivery, or stores nothing.

**CLI**

```bash
sylphx events events publish-service-event
```

`POST https://api.sylphx.com/v1/events:publishServiceEvent` · scope `events:publish` · effect `write` · [Request, response and examples](/docs/api/events/publish_service_event)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--parent` | `string` | The consenting tenant environment: orgs/&#123;org&#125;/projects/&#123;project&#125;/envs/&#123;env&#125;. Required. |
| `--event` | `json` | source must be sylphx.&lt;service&gt; and type must start with &lt;service&gt;. Required. |
| `--webhook-uri` | `string` | Exact registered https endpoint URI; empty uses ordinary environment fan-out. |

## get

Gets an event.

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

**CLI**

```bash
sylphx events events get orgs/acme/projects/shop/envs/production/events/event
```

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

## list

Lists events.

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

**CLI**

```bash
sylphx events events list orgs/acme/projects/shop/envs/production
```

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/events` · scope `events:read` · effect `read` · [Request, response and examples](/docs/api/events/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. |
