> ## 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: versiones, usuarios y configuración

> Rutas del Studio usadas por el panel y por el MCP.

Estas son las rutas que usan el panel del Studio y el MCP. Valen los mismos tokens y alcances de la API.

| Método | Ruta | Qué hace | Alcance |
| - | - | - | - |
| `GET` | `/scripts/studio/catalog` | Tipos de script, Skill, guías, plantillas de función y datos del MCP (dirección, alcances, herramientas, logos) | cualquier autenticación |
| `POST` | `/scripts/studio/create` | Crea un script con la plantilla inicial (solo dueño/admin de DoglyTdc) | `scripts.write` |
| `GET` | `/scripts/{script_id}/studio/releases` | Versiones publicadas (hasta 100) | `scripts.read` |
| `POST` | `/scripts/{script_id}/studio/releases` | Publica una versión | `scripts.publish` |
| `POST` | `/scripts/{script_id}/studio/releases/{release_id}/rollback` | Vuelve el canal a una versión anterior | `scripts.publish` |
| `POST` | `/scripts/{script_id}/studio/merge` | Compara (`dry_run: true`, por defecto) o fusiona branches | `scripts.read` / `scripts.write` |
| `GET` | `/scripts/{script_id}/studio/users` | Quién usó el script (hasta 200), solo el dueño | `users.manage` |
| `PATCH` | `/scripts/{script_id}/studio/users/{id}` | Banear, desactivar o reactivar, solo el dueño | `users.manage` |
| `GET` | `/scripts/{script_id}/studio/user-events[/{id}]` | Últimas 100 aperturas y acciones, solo el dueño | `users.manage` |
| `GET` / `POST` | `/scripts/{script_id}/studio/pause` | Ver o cambiar la pausa para todos, solo el dueño | `users.manage` |
| `GET` / `PUT` | `/scripts/{script_id}/studio/config` | Configuración remota (`values`) | `scripts.read` / `scripts.write` |
| `GET` | `/scripts/{script_id}/studio/errors` | Últimos 100 errores enviados por `reportError` | `scripts.read` |
| `GET` | `/scripts/{script_id}/studio/metrics` | Números de uso del script | `scripts.read` |
| `GET` | `/scripts/{script_id}/studio/sales` | Planes a la venta y accesos activos, solo el dueño | `scripts.read` |

## Publicar una versión

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

| Campo | Regla |
| - | - |
| `version` | Número `x.y.z` (puede tener sufijo, como `1.2.0-beta.1`). Debe ser mayor que la versión activa del canal y no puede repetirse. |
| `notes` | Notas de la versión, hasta 5.000 caracteres |
| `channel` | `stable` (por defecto) o `beta` |
| `branch` | Estable sale **solo** de la branch principal. Beta sale de una branch **distinta** de la principal. |
| `confirm_unprotected` | Obligatorio `true` cuando la protección del script está desactivada |

Qué pasa: DoglyTdc junta `src/`, revisa la sintaxis, compacta, verifica el tamaño (hasta 2 MB), cifra el paquete y activa la versión en el canal. Si el cifrado falla, no se publica nada.

Respuesta `201`:

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

Errores: `UNPROTECTED_CONFIRM` (409), `VERSION_EXISTS` (409), `INVALID_FORM_BODY` (400, número menor o branch equivocada), `BUILD_FAILED` (400, error al juntar o de sintaxis), `PAYLOAD_TOO_LARGE` (413), `SEAL_FAILED` (500).

## Volver a una versión

`POST …/studio/releases/{release_id}/rollback` convierte esa versión en la activa de su canal. Respuesta: `{ "ok": true, "live": "1.1.0", "channel": "stable" }`.

## Banear, desactivar o reactivar

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

`status` = `active`, `disabled` (con `until` opcional) o `banned`. Vale la próxima vez que la persona abra el script. La lista de usuarios muestra `@username`, estado, versión, sitio, número de usos, primera y última vez, y si la persona tiene acceso pago activo — nunca el ID de la cuenta.


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