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

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

## get

Gets a Chat profile and fresh presence.

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

**CLI**

```bash
sylphx events chat-profiles get orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile
```

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

## configure

Configures an authenticated Chat identity through its trusted backend.

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

**CLI**

```bash
sylphx events chat-profiles configure orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile:configure` · scope `events:write` · effect `write` · [Request, response and examples](/docs/api/chat_profiles/configure)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--terms-version` | `string` | Accepted code of conduct version. |
| `--display-name` | `string` | User-visible name. |
| `--allow-stranger-images` | `bool` | Explicit opt-in; default false. |
| `--quiet-hours-start-utc-minute` | `int` | UTC quiet hours, optional as a pair; start equals end disables quiet hours. |
| `--quiet-hours-end-utc-minute` | `int` | UTC exclusive end, including midnight as 1440. |
| `--cosmetics` | `json` | Trusted-backend only, including an empty object. Omission preserves the current appearance; player sessions cannot set or clear it. |

## set-relationship

Changes friendship or a bilateral interaction block.

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

**CLI**

```bash
sylphx events chat-profiles set-relationship orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile:setRelationship` · scope `events:write` · effect `write` · [Request, response and examples](/docs/api/chat_profiles/set_relationship)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--peer-id` | `string` | Other user's stable client id. Required. |
| `--action` | `string` | request, accept, remove, block or unblock. Required. |

## list-relationships

Lists friends and pending requests with presence.

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

**CLI**

```bash
sylphx events chat-profiles list-relationships orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile
```

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile:listRelationships` · scope `events:read` · effect `read` · [Request, response and examples](/docs/api/chat_profiles/list_relationships)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--page-size` | `int` | Maximum results; default 50, maximum 1000. |
| `--page-token` | `string` | Previous response's next_page_token. |

## report

Reports a message, image or user to the moderation queue.

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

**CLI**

```bash
sylphx events chat-profiles report orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile:report` · scope `events:write` · effect `write` · [Request, response and examples](/docs/api/chat_profiles/report)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--target-type` | `string` | message, image or user. |
| `--target-id` | `string` | Full message name, image SHA-256 or user id. |
| `--reason` | `string` | Report reason. |

## review-media

Registers an image and its automated moderation receipt.

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

**CLI**

```bash
sylphx events chat-profiles review-media orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile:reviewMedia` · scope `events:write` · effect `write` · [Request, response and examples](/docs/api/chat_profiles/review_media)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--sha256` | `string` | Lowercase SHA-256 digest. |
| `--content-uri` | `string` | Exact existing storage URI. |
| `--status` | `string` | pending registers an upload; approved or rejected is a backend moderation receipt. |
| `--reason` | `string` | Administrator-only moderation reason; player status/reason are never trusted. |

## set-official-status

Verifies an official account through a distinct administrator permission.

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

**CLI**

```bash
sylphx events chat-profiles set-official-status orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile:setOfficialStatus` · scope `events:chat:admin` · effect `write` · [Request, response and examples](/docs/api/chat_profiles/set_official_status)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--official` | `bool` | Verified status; regular profile configuration never changes this flag. |

## bind-identity

Records an exact Auth-verified guest-to-platform identity link grant.

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

**CLI**

```bash
sylphx events chat-profiles bind-identity orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile:bindIdentity` · scope `events:chat:admin` · effect `write` · [Request, response and examples](/docs/api/chat_profiles/bind_identity)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--source-client-id` | `string` | Title-scoped guest identity whose Auth link has been verified. |
| `--link-receipt-id` | `string` | Immutable receipt from the verified Auth link. |

## merge-identity

Rehomes linked guest state without discarding messages or relationships.

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

**CLI**

```bash
sylphx events chat-profiles merge-identity orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile:mergeIdentity` · scope `events:chat:admin` · effect `write` · [Request, response and examples](/docs/api/chat_profiles/merge_identity)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--source-client-id` | `string` | Previously bound title-scoped guest identity. |
| `--link-receipt-id` | `string` | Exact prior Auth-verified source/target receipt binding. |

## register-push-device

Registers a browser device using only the authenticated Chat session.

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

**CLI**

```bash
sylphx events chat-profiles register-push-device orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile:registerPushDevice` · scope `events:write` · effect `write` · [Request, response and examples](/docs/api/chat_profiles/register_push_device)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--sender` | `string` | Existing Notify Sender in this environment. Required. |
| `--device-token` | `string` | Exact JSON string from PushSubscription.toJSON(); never returned or logged. Required. The value is never returned. |

## unregister-push-device

Removes this session's exact upstream device epoch; stale logout is a no-op.

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

**CLI**

```bash
sylphx events chat-profiles unregister-push-device orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile:unregisterPushDevice` · scope `events:write` · effect `write` · [Request, response and examples](/docs/api/chat_profiles/unregister_push_device)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--registration` | `json` | Exact receipt from RegisterChatPushDevice. Required. |

## issue-token

Issues a bounded player capability after verified Auth token exchange.

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

**CLI**

```bash
sylphx events chat-profiles issue-token orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile
```

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/chat_profiles/chat-profile:issueToken` · scope `events:write` · effect `write` · [Request, response and examples](/docs/api/chat_profiles/issue_token)

**Flags**

| Flag | Type | What it does |
| --- | --- | --- |
| `--ttl` | `duration` | Lifetime, 60s to 3600s; default 3600s. |