> ## 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: versões, usuários e configuração

> Rotas do Studio usadas pelo painel e pelo MCP.

Estas rotas são as que o painel do Studio e o MCP usam. Valem os mesmos tokens e escopos da API.

| Método | Caminho | O que faz | Escopo |
| - | - | - | - |
| `GET` | `/scripts/studio/catalog` | Tipos de script, Skill, guias, modelos de função e dados do MCP (endereço, escopos, ferramentas, logos) | qualquer autenticação |
| `POST` | `/scripts/studio/create` | Cria um script com o modelo inicial (só dono/admin do DoglyTdc) | `scripts.write` |
| `GET` | `/scripts/{script_id}/studio/releases` | Versões publicadas (até 100) | `scripts.read` |
| `POST` | `/scripts/{script_id}/studio/releases` | Publica uma versão | `scripts.publish` |
| `POST` | `/scripts/{script_id}/studio/releases/{release_id}/rollback` | Volta o canal para uma versão anterior | `scripts.publish` |
| `POST` | `/scripts/{script_id}/studio/merge` | Compara (`dry_run: true`, padrão) ou mescla branches | `scripts.read` / `scripts.write` |
| `GET` | `/scripts/{script_id}/studio/users` | Quem usou o script (até 200), só o dono | `users.manage` |
| `PATCH` | `/scripts/{script_id}/studio/users/{id}` | Banir, desativar ou reativar, só o dono | `users.manage` |
| `GET` | `/scripts/{script_id}/studio/user-events[/{id}]` | Últimas 100 aberturas e ações, só o dono | `users.manage` |
| `GET` / `POST` | `/scripts/{script_id}/studio/pause` | Ver ou mudar a pausa para todos, só o dono | `users.manage` |
| `GET` / `PUT` | `/scripts/{script_id}/studio/config` | Configuração remota (`values`) | `scripts.read` / `scripts.write` |
| `GET` | `/scripts/{script_id}/studio/errors` | Últimos 100 erros enviados por `reportError` | `scripts.read` |
| `GET` | `/scripts/{script_id}/studio/metrics` | Números de uso do script | `scripts.read` |
| `GET` | `/scripts/{script_id}/studio/sales` | Planos à venda e acessos ativos, só o dono | `scripts.read` |

## Publicar uma versão

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

| Campo | Regra |
| - | - |
| `version` | Número `x.y.z` (pode ter sufixo, como `1.2.0-beta.1`). Precisa ser maior que a versão ativa do canal e não pode repetir. |
| `notes` | Notas da versão, até 5.000 caracteres |
| `channel` | `stable` (padrão) ou `beta` |
| `branch` | Estável sai **só** da branch principal. Beta sai de uma branch **diferente** da principal. |
| `confirm_unprotected` | Obrigatório `true` quando a proteção do script está desligada |

O que acontece: o DoglyTdc junta `src/`, confere a sintaxe, compacta, verifica o tamanho (até 2 MB), criptografa o pacote e ativa a versão no canal. Se a criptografia falhar, nada é publicado.

Resposta `201`:

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

Erros: `UNPROTECTED_CONFIRM` (409), `VERSION_EXISTS` (409), `INVALID_FORM_BODY` (400, número menor ou branch errada), `BUILD_FAILED` (400, erro ao juntar ou de sintaxe), `PAYLOAD_TOO_LARGE` (413), `SEAL_FAILED` (500).

## Voltar uma versão

`POST …/studio/releases/{release_id}/rollback` torna aquela versão a ativa do canal dela. Resposta: `{ "ok": true, "live": "1.1.0", "channel": "stable" }`.

## Banir, desativar ou reativar

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

`status` = `active`, `disabled` (com `until` opcional) ou `banned`. Vale na próxima vez que a pessoa abrir o script. A lista de usuários mostra `@username`, status, versão, site, número de usos, primeira e última vez, e se a pessoa tem acesso pago ativo — nunca o ID da conta.


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