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

# Repositorio

> Rutas de la API de Scripts: repositorio.

| Método | Ruta | Qué hace |
| - | - | - |
| `GET` | `/scripts/{script_id}/repo/branches` | Ramas del repositorio. |
| `POST` | `/scripts/{script_id}/repo/branches` | Crea una rama a partir de un commit (por defecto: head de main). |
| `GET` | `/scripts/{script_id}/repo/tree` | Lista de archivos de una referencia. |
| `GET` | `/scripts/{script_id}/repo/files/{path*}` | Contenido de un archivo. ?raw=1 devuelve texto sin formato. |
| `GET` | `/scripts/{script_id}/repo/commits` | Historial (primer padre), opcionalmente filtrado por archivo. |
| `GET` | `/scripts/{script_id}/repo/commits/{sha}` | Un commit con la lista de archivos modificados. |
| `POST` | `/scripts/{script_id}/repo/commits` | Guarda archivos en un commit. content:null elimina. expected\_head evita sobrescribir el trabajo ajeno (409 HEAD\_MOVED). En la rama predeterminada publica el backend; modificar supabase/ requiere functions.deploy. |

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

Ramas del repositorio.

**Autenticación:** Alcance: `scripts.read`

**Parámetros de ruta:** `script_id`

**Respuesta:** `{ 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

Crea una rama a partir de un commit (por defecto: head de main).

**Autenticación:** Alcance: `scripts.write`

**Parámetros de ruta:** `script_id`

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

**Respuesta:** `{ 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 archivos de una referencia.

**Autenticación:** Alcance: `scripts.read`

**Parámetros de ruta:** `script_id`

**Parámetros de la URL:** `ref? (rama o sha)`

**Respuesta:** `{ 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\*}

Contenido de un archivo. ?raw=1 devuelve texto sin formato.

**Autenticación:** Alcance: `scripts.read`

**Parámetros de ruta:** `script_id`, `path*`

**Parámetros de la URL:** `ref?, raw?`

**Respuesta:** `{ 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

Historial (primer padre), opcionalmente filtrado por archivo.

**Autenticación:** Alcance: `scripts.read`

**Parámetros de ruta:** `script_id`

**Parámetros de la URL:** `ref?, path?, limit? (1-100, por defecto 30)`

**Respuesta:** `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}

Un commit con la lista de archivos modificados.

**Autenticación:** Alcance: `scripts.read`

**Parámetros de ruta:** `script_id`, `sha`

**Respuesta:** `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

Guarda archivos en un commit. content:null elimina. expected\_head evita sobrescribir el trabajo ajeno (409 HEAD\_MOVED). En la rama predeterminada publica el backend; modificar supabase/ requiere functions.deploy.

**Autenticación:** Alcance: `scripts.write`

> [!NOTE]
>
> Usa `expected_head` con el `head_sha` leído en `GET /repo/branches`. Si la rama cambió entretanto, el servidor responde `409 HEAD_MOVED` y no se guarda nada. En la rama principal, modificar `supabase/` también requiere `functions.deploy`, y el backend se publica de inmediato (el resumen viene en `deploy`). Límite: 30 commits por minuto por persona y script; hasta 100 archivos por commit.

**Parámetros de ruta:** `script_id`

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

**Respuesta:** `{ 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.