> ## 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.

# Repositório

> Rotas da API do Scripts: repositório.

| Método | Caminho | O que faz |
| - | - | - |
| `GET` | `/scripts/{script_id}/repo/branches` | Branches do repositório. |
| `POST` | `/scripts/{script_id}/repo/branches` | Cria uma branch a partir de um commit (padrão: head da main). |
| `GET` | `/scripts/{script_id}/repo/tree` | Lista de arquivos de um ref. |
| `GET` | `/scripts/{script_id}/repo/files/{path*}` | Conteúdo de um arquivo. ?raw=1 devolve texto puro. |
| `GET` | `/scripts/{script_id}/repo/commits` | Histórico (primeiro pai), opcionalmente filtrado por arquivo. |
| `GET` | `/scripts/{script_id}/repo/commits/{sha}` | Um commit com a lista de arquivos alterados. |
| `POST` | `/scripts/{script_id}/repo/commits` | Grava arquivos num commit. content:null apaga. expected\_head evita sobrescrever trabalho alheio (409 HEAD\_MOVED). Na branch padrão publica o backend; mexer em supabase/ exige functions.deploy. |

## GET /scripts/\{script\_id}/repo/branches

Branches do repositório.

**Autenticação:** Escopo: `scripts.read`

**Parâmetros do caminho:** `script_id`

**Resposta:** `{ name, head_sha, is_default, created_by, updated_at }[]`

```bash cURL theme={null}
curl -X GET "https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-scripts-api/scripts/{script_id}/repo/branches" \
  -H "Authorization: Bearer dts_SEU_TOKEN"
```

## POST /scripts/\{script\_id}/repo/branches

Cria uma branch a partir de um commit (padrão: head da main).

**Autenticação:** Escopo: `scripts.write`

**Parâmetros do caminho:** `script_id`

**Corpo:** `{ name, from? }`

**Resposta:** `{ name, head_sha }`

```bash cURL theme={null}
curl -X POST "https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-scripts-api/scripts/{script_id}/repo/branches" \
  -H "Authorization: Bearer dts_SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"nova-tela"}'
```

## GET /scripts/\{script\_id}/repo/tree

Lista de arquivos de um ref.

**Autenticação:** Escopo: `scripts.read`

**Parâmetros do caminho:** `script_id`

**Parâmetros da URL:** `ref? (branch ou sha)`

**Resposta:** `{ ref, sha, files: { path, hash, size }[] }`

```bash cURL theme={null}
curl -X GET "https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-scripts-api/scripts/{script_id}/repo/tree" \
  -H "Authorization: Bearer dts_SEU_TOKEN"
```

## GET /scripts/\{script\_id}/repo/files/\{path\*}

Conteúdo de um arquivo. ?raw=1 devolve texto puro.

**Autenticação:** Escopo: `scripts.read`

**Parâmetros do caminho:** `script_id`, `path*`

**Parâmetros da URL:** `ref?, raw?`

**Resposta:** `{ ref, sha, path, hash, content }`

```bash cURL theme={null}
curl -X GET "https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-scripts-api/scripts/{script_id}/repo/files/src/script.js" \
  -H "Authorization: Bearer dts_SEU_TOKEN"
```

## GET /scripts/\{script\_id}/repo/commits

Histórico (primeiro pai), opcionalmente filtrado por arquivo.

**Autenticação:** Escopo: `scripts.read`

**Parâmetros do caminho:** `script_id`

**Parâmetros da URL:** `ref?, path?, limit? (1-100, padrão 30)`

**Resposta:** `Commit[]`

```bash cURL theme={null}
curl -X GET "https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-scripts-api/scripts/{script_id}/repo/commits" \
  -H "Authorization: Bearer dts_SEU_TOKEN"
```

## GET /scripts/\{script\_id}/repo/commits/\{sha}

Um commit com a lista de arquivos alterados.

**Autenticação:** Escopo: `scripts.read`

**Parâmetros do caminho:** `script_id`, `sha`

**Resposta:** `Commit & { files: { path, status }[] }`

```bash cURL theme={null}
curl -X GET "https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-scripts-api/scripts/{script_id}/repo/commits/{sha}" \
  -H "Authorization: Bearer dts_SEU_TOKEN"
```

## POST /scripts/\{script\_id}/repo/commits

Grava arquivos num commit. content:null apaga. expected\_head evita sobrescrever trabalho alheio (409 HEAD\_MOVED). Na branch padrão publica o backend; mexer em supabase/ exige functions.deploy.

**Autenticação:** Escopo: `scripts.write`

> [!NOTE]
>
> Use `expected_head` com o `head_sha` lido em `GET /repo/branches`. Se a branch mudou nesse meio-tempo, o servidor responde `409 HEAD_MOVED` e nada é gravado. Na branch principal, mexer em `supabase/` exige também `functions.deploy`, e o backend é publicado na mesma hora (o resumo vem em `deploy`). Limite: 30 commits por minuto por pessoa e script; até 100 arquivos por commit.

**Parâmetros do caminho:** `script_id`

**Corpo:** `{ branch?, expected_head, message, description?, changes: { path, content|null }[] }`

**Resposta:** `{ commit, branch, deploy? }`

```bash cURL theme={null}
curl -X POST "https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-scripts-api/scripts/{script_id}/repo/commits" \
  -H "Authorization: Bearer dts_SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"expected_head":"<head_sha>","message":"Atualiza script","changes":[{"path":"src/script.js","content":"console.log(1)"}]}'
```


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