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

# Changes and permissions

> What an AI assistant connected to Streampixel may change, how View only and View and make changes work, and how every change is confirmed with preview_change.

> [!NOTE]
>
> **Beta.** The Streampixel command line (version 0.1.0-beta.1) and the Streampixel MCP server are in beta. Commands, tools and their output can still change before the stable release.

## What the assistant may do

When you sign in, you choose one of two options:

* **View only** (recommended): the assistant can read your account but change nothing.
* **View and make changes**: the assistant can also use the change tools below, always with your confirmation.

Either way, it can never do more than you can in the dashboard, and it never sees other accounts.

## The change tools

| Tool | What it does |
| - | - |
| `set_project_enabled` | Turns a project on or off. Turning it off ends every live and queued session of the project. |
| `end_sessions` | Ends every live and queued session of a project without turning it off. New viewers can join straight away. |
| `set_active_build` | Makes a processed build the live one and switches the project on. |
| `update_project_settings` | Changes streaming and player settings. Plan, region, concurrent users, on/off and builds cannot be changed this way. If one field is invalid, nothing is changed. |

They do exactly what the [project control endpoints](https://docs.streampixel.io/resources/api-reference/enable-project.md) of the REST API do. On a **View only** connection they are refused, whatever the assistant tries.

## Every change needs your confirmation

Every change takes two steps:

1. The assistant calls `preview_change`. It says what would happen and returns a one-time code.
2. The assistant shows you that, and makes the change with the code only if you say yes.

A code is valid for one change and two minutes.

> [!WARNING]
>
> Turning a project off ends its live sessions immediately.


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