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

# Studio: versions, users and configuration

> Studio routes used by the panel and the MCP.

These are the routes the Studio panel and the MCP use. The same API tokens and scopes apply.

| Method | Path | What it does | Scope |
| - | - | - | - |
| `GET` | `/scripts/studio/catalog` | Script types, Skill, guides, function templates and MCP data (address, scopes, tools, logos) | any authentication |
| `POST` | `/scripts/studio/create` | Creates a script from the starter template (DoglyTdc owner/admin only) | `scripts.write` |
| `GET` | `/scripts/{script_id}/studio/releases` | Published versions (up to 100) | `scripts.read` |
| `POST` | `/scripts/{script_id}/studio/releases` | Publishes a version | `scripts.publish` |
| `POST` | `/scripts/{script_id}/studio/releases/{release_id}/rollback` | Rolls the channel back to an earlier version | `scripts.publish` |
| `POST` | `/scripts/{script_id}/studio/merge` | Compares (`dry_run: true`, default) or merges branches | `scripts.read` / `scripts.write` |
| `GET` | `/scripts/{script_id}/studio/users` | Who used the script (up to 200), owner only | `users.manage` |
| `PATCH` | `/scripts/{script_id}/studio/users/{id}` | Ban, disable or reactivate, owner only | `users.manage` |
| `GET` | `/scripts/{script_id}/studio/user-events[/{id}]` | Last 100 opens and actions, owner only | `users.manage` |
| `GET` / `POST` | `/scripts/{script_id}/studio/pause` | See or change the pause for everyone, owner only | `users.manage` |
| `GET` / `PUT` | `/scripts/{script_id}/studio/config` | Remote configuration (`values`) | `scripts.read` / `scripts.write` |
| `GET` | `/scripts/{script_id}/studio/errors` | Last 100 errors sent by `reportError` | `scripts.read` |
| `GET` | `/scripts/{script_id}/studio/metrics` | Script usage numbers | `scripts.read` |
| `GET` | `/scripts/{script_id}/studio/sales` | Plans on sale and active access, owner only | `scripts.read` |

## Publish a version

```json theme={null}
{
  "version": "1.2.0",
  "notes": "Corrige o popup",
  "channel": "stable",
  "branch": "main",
  "confirm_unprotected": false
}
```

| Field | Rule |
| - | - |
| `version` | An `x.y.z` number (may have a suffix, like `1.2.0-beta.1`). Must be greater than the channel's active version and cannot repeat. |
| `notes` | Release notes, up to 5,000 characters |
| `channel` | `stable` (default) or `beta` |
| `branch` | Stable comes **only** from the main branch. Beta comes from a branch **other** than main. |
| `confirm_unprotected` | Must be `true` when the script's protection is off |

What happens: DoglyTdc bundles `src/`, checks syntax, minifies, checks the size (up to 2 MB), encrypts the package and activates the version on the channel. If encryption fails, nothing is published.

Response `201`:

```json theme={null}
{ "id": "…", "version": "1.2.0", "channel": "stable", "compacted": true, "size_bytes": 18234, "commit_sha": "…" }
```

Errors: `UNPROTECTED_CONFIRM` (409), `VERSION_EXISTS` (409), `INVALID_FORM_BODY` (400, lower number or wrong branch), `BUILD_FAILED` (400, bundling or syntax error), `PAYLOAD_TOO_LARGE` (413), `SEAL_FAILED` (500).

## Roll back a version

`POST …/studio/releases/{release_id}/rollback` makes that version the active one on its channel. Response: `{ "ok": true, "live": "1.1.0", "channel": "stable" }`.

## Ban, disable or reactivate

```json theme={null}
{ "status": "disabled", "reason": "Uso indevido", "until": "2026-12-01T00:00:00Z" }
```

`status` = `active`, `disabled` (with optional `until`) or `banned`. It takes effect the next time the person opens the script. The user list shows `@username`, status, version, site, number of uses, first and last time, and whether the person has active paid access — never the account ID.


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