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

> Criando, listando e obtendo credenciais de databases

O recurso `sonder.databases` cria e gerencia bancos de dados gerenciados na plataforma. Esta página cobre criação, listagem, detalhes e remoção. Para start/stop/restart veja [Ciclo de Vida](https://docs.sondercloud.app/sdk/databases/ciclo-de-vida.md), e para logs e métricas veja [Logs & Estatísticas](https://docs.sondercloud.app/sdk/databases/logs-e-estatisticas.md).

## Criar uma database

```ts theme={null}
const db = await sonder.databases.create({
  name: 'meu-banco',
  engine: 'postgresql',
  memoryMb: 256,
});

console.log(db.connectionString);
```

**name** `string` *required*

Nome de exibição da database (1 a 32 caracteres).

**engine** `'postgresql' | 'mysql' | 'mongodb' | 'redis'` *required*

Engine desejada.

**memoryMb** `number` (default: 128)

Limite de memória em MB, entre 64 e 2048.

**password** `string`

Senha customizada (8 a 128 caracteres).

**teamId** `string`

ID do time dono da database, se aplicável.

A resposta (`CreatedDatabase`) inclui as credenciais completas geradas: `host`, `port`, `username`, `password` e `connectionString`.

> [!NOTE]
>
> A senha real gerada só aparece nesta resposta de criação e em [`get()`](#obter-detalhes-e-credenciais) — `list()` não retorna a senha.

## Listar databases

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

Retorna um array de `DatabaseListItem`, com `id`, `name`, `engine`, `status`, `memoryMb`, `host`, `port`, `connectionString` (sem senha), entre outros.

## Obter detalhes e credenciais

```ts theme={null}
const db = await sonder.databases.get(databaseId);
console.log(db.connectionString, db.internalConnectionString);
```

`DatabaseDetails` inclui credenciais completas (com senha), `internalHost`/`internalPort` para conexões dentro da rede interna do SonderCloud, e `accessNote` explicando as duas formas de acesso.

## Remover

```ts theme={null}
const result = await sonder.databases.delete(databaseId);
// { deleted: true }
```

> [!WARNING]
>
> A remoção é permanente e não tem confirmação adicional — o container e os dados são apagados imediatamente.

## Referência de métodos

| Método | Rota | Descrição |
| - | - | - |
| `databases.create(params)` | `POST /v1/databases` | Cria uma nova database. |
| `databases.list()` | `GET /v1/databases` | Lista todas as databases do usuário. |
| `databases.get(id)` | `GET /v1/databases/:id` | Detalhes e credenciais completas de uma database. |
| `databases.delete(id)` | `DELETE /v1/databases/:id` | Remove uma database permanentemente. |


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