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

# Visão Geral

> Listagem, detalhes, estatísticas, logs e ciclo de vida

O recurso `sonder.apps` interage com as aplicações implantadas na plataforma. Esta página cobre leitura de dados e ciclo de vida (start/stop/restart/rebuild/delete). Para criar ou substituir código, veja [Upload & Deploy](https://docs.sondercloud.app/sdk/aplicacoes/upload.md) e [Commit & Backup](https://docs.sondercloud.app/sdk/aplicacoes/commit-backup.md). Para o filesystem remoto, veja [Arquivos](https://docs.sondercloud.app/sdk/aplicacoes/arquivos.md).

> [!NOTE]
>
> Todo método que recebe `appId` valida o formato antes de chamar a API. Um ID que não seja um UUID v4 válido lança erro localmente, sem requisição de rede.

## Listar aplicações

```ts theme={null}
const apps = await sonder.apps.list();
```

**GET** `/v1/apps`

Retorna um array de `AppListItem`, com `id`, `name`, `status`, `running`, `memoryMb`, `domain`, entre outros campos.

## Obter detalhes

```ts theme={null}
const app = await sonder.apps.get(appId);
```

Retorna `AppDetails`, incluindo `command`, `imageTag`, `createdAt`, `memoryUsage`, `oomKilled` e `oomNotified`.

## Estatísticas de uso

```ts theme={null}
const stats = await sonder.apps.stats(appId);
// { running, cpu, ram, ramPercent, networkRx, networkTx, pids }
```

## Logs

```ts theme={null}
const { logs } = await sonder.apps.logs(appId, { tail: 200 });
```

**tail** `number` (default: 100)

Número de linhas finais do log a retornar. O padrão de 100 é aplicado pela API quando omitido.

## Ciclo de vida

```ts theme={null}
await sonder.apps.start(appId);
await sonder.apps.stop(appId);
await sonder.apps.restart(appId);
await sonder.apps.rebuild(appId); // reconstrói a imagem a partir do código atual
await sonder.apps.delete(appId);  // remoção permanente
```

## Referência de métodos

| Método | Rota | Descrição |
| - | - | - |
| `apps.list()` | `GET /v1/apps` | Lista todas as aplicações do usuário. |
| `apps.get(appId)` | `GET /v1/apps/:id` | Detalhes de uma aplicação. |
| `apps.stats(appId)` | `GET /v1/apps/:id/stats` | Uso de CPU, RAM e rede. |
| `apps.logs(appId, { tail })` | `GET /v1/apps/:id/logs` | Últimas linhas de log. |
| `apps.start(appId)` | `POST /v1/apps/:id/start` | Inicia a aplicação. |
| `apps.stop(appId)` | `POST /v1/apps/:id/stop` | Para a aplicação. |
| `apps.restart(appId)` | `POST /v1/apps/:id/restart` | Reinicia a aplicação. |
| `apps.rebuild(appId)` | `POST /v1/apps/:id/rebuild` | Reconstrói a imagem. |
| `apps.delete(appId)` | `POST /v1/apps/:id/delete` | Remove a aplicação. |


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