> ## Documentation Index
> Fetch the complete documentation index at: https://docs.photon.codes/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Use Stable documentation by default. Honor an explicit Beta request or a URL under /docs/beta/. If the requested version conflicts with the installed CLI package or API origin, clarify the target before writing integration code.
> Pages under /docs/beta/ document Beta; other product pages document Stable. Keep the CLI package, commands, API origin, and credentials within the selected version. State the documentation version in your answer.
> For MCP search, always pass version: Stable or version: Beta. Unfiltered search mixes both versions. For filesystem reads, keep Beta queries under /beta/ and exclude /beta/ from Stable queries; discover paths before reading them.
> The public docs base is https://photon.codes/docs. Convert MCP page paths to public URLs under that base, preserving /beta/ when present. Read https://photon.codes/docs/skill.md for version selection and https://photon.codes/docs/llms.txt for the version indexes.

# Spectrum

> Manage Spectrum profiles, users, lines, platforms, and avatars from the CLI

The `photon spectrum` commands manage your project's messaging configuration — the Spectrum profile, users, phone lines, platform toggles, and avatar.

All Spectrum commands require an active project. Set `$PHOTON_PROJECT_ID` or pass `--project <id>`.

## Spectrum profile

View or update the Spectrum profile attached to your project.

```sh theme={null}
# View the current profile
photon spectrum profile show

# Update profile fields
photon spectrum profile update --display-name "Support Bot"
```

Aliases: `spectrum profile edit`.

## Users

Manage users that can interact through your project's Spectrum instance.

### List users

```sh theme={null}
photon spectrum users ls
photon spectrum users ls --json
```

Aliases: `spectrum users list`.

### Add a user

```sh theme={null}
photon spectrum users add
```

Aliases: `spectrum users create`.

### Remove a user

```sh theme={null}
photon spectrum users remove <user-id>
```

> [!WARNING]
>
> Removing a user is irreversible. The CLI asks for confirmation unless you pass `-y`.

Aliases: `spectrum users rm`, `spectrum users delete`.

## Lines

Manage the phone lines assigned to your project.

### List lines

```sh theme={null}
photon spectrum lines ls
```

Aliases: `spectrum lines list`.

### Add a line

```sh theme={null}
photon spectrum lines add
```

Currently supports iMessage lines only.

### Remove a line

```sh theme={null}
photon spectrum lines remove <line-id>
```

## Platforms

View and toggle messaging platforms for your project.

### List platforms

```sh theme={null}
photon spectrum platforms ls
```

Aliases: `spectrum platforms list`.

### Enable a platform

```sh theme={null}
photon spectrum platforms enable <platform-name>
```

### Disable a platform

```sh theme={null}
photon spectrum platforms disable <platform-name>
```

## Avatar

Upload a custom avatar image for your project's Spectrum profile.

```sh theme={null}
photon spectrum avatar upload photo.png
```

The CLI requests a presigned upload URL from the API, uploads the file directly, and patches the Spectrum profile to use it.

[See the generated command and option reference](https://docs.photon.codes/docs/legacy/cli/reference/spectrum.md).

## Common flags

[See the generated command and option reference](https://docs.photon.codes/docs/legacy/cli/reference/spectrum.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.