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

# Informações do usuário

> Retorna as informações completas do usuário, incluindo aplicações, bancos de dados, plano e conexões OAuth.

### Resposta

**response** `APIUserInfoResponse`

Dados completos do usuário autenticado.

**Mostrar objeto**

**id** `string`

ID único do usuário (Snowflake).

**email** `string`

E-mail do usuário.

**name** `string`

Nome de exibição do usuário.

**language** `string`

Idioma preferido do usuário (`pt-br`, `en-us`, `es-es`).

**created\_at** `string`

Data de criação da conta (ISO 8601).

**updated\_at** `string`

Data da última atualização da conta (ISO 8601).

**plan** `APIUserPlan | null`

Informações do plano atual, ou `null` quando a conta não tem plano ativo. Uma conta sem plano não pode
criar aplicações ou bancos de dados (`PLAN_REQUIRED`).

**Mostrar objeto**

**name** `string`

O nome do plano: `economy`, `pro`, `scale`, `intermediary` ou `enterprise-<GB>`, em que `<GB>` é 4, 6, 8, 12, 14, 16,
18, 20, 22, 24, 26, 28, 30 ou 32 (por exemplo, `enterprise-8`). O nome é o único identificador do plano.

**expires\_at** `string`

Data de expiração do plano.

**duration** `integer`

Duração do plano em dias.

**memory** `APIUserPlanMemory`

Uso de memória do plano.

**Mostrar objeto**

**limit** `integer`

Limite de memória em MB.

**used** `integer`

Memória em uso no momento, em MB.

**applications** `APIApplication[]`

Lista das aplicações do usuário.

**Mostrar objeto**

**id** `string`

ID único da aplicação (Snowflake).

**cluster** `integer`

ID do cluster que hospeda a aplicação.

**type** `integer`

Tipo da aplicação. `1` = Bot, `2` = Site.

**name** `string`

Nome da aplicação.

**description** `string | undefined`

Descrição da aplicação.

**language** `string`

Linguagem de programação (`javascript`, `typescript`, `python`, `go`, `php`, `ruby`, `java`, `rust`, `bun`, `deno`, `dotnet`, `elixir`, `static`).

**ram** `integer`

Memória alocada em MB.

**status** `string`

Status atual: `up`, `down` ou `building`.

**subdomain** `string | null`

Subdomínio da aplicação.

**domains** `APIApplicationDomain[]`

Os domínios personalizados da aplicação, com status, porta, prefixo de caminho e redirecionamento. Vazio quando
não há nenhum. Os campos estão descritos em [Listar domínios da aplicação](https://docs.vertracloud.app/pt-br/api-reference/endpoint/apps/domains/list.md#resposta).

**owner\_plan** `string | null`

O nome do plano do dono, ou `null` quando o dono não tem plano.

**main\_file** `string`

Arquivo principal da aplicação.

**version** `string`

Versão do runtime (`recommended`, `latest` ou uma versão específica).

**last\_snapshot** `string | null`

Data do último snapshot.

**offline\_since** `string | null`

Data desde quando a aplicação está offline. `null` se estiver online.

**created\_at** `string`

Data de criação.

**updated\_at** `string`

Data da última atualização.

**databases** `APIDatabase[]`

Lista dos bancos de dados do usuário.

**Mostrar objeto**

**id** `string`

ID único do banco de dados (Snowflake).

**cluster** `integer`

ID do cluster.

**type** `integer`

Tipo: `1` = PostgreSQL, `2` = MongoDB, `3` = Redis, `4` = MySQL.

**owner\_plan** `string | null`

O nome do plano do dono (por exemplo, `pro`), ou `null` quando o dono não tem plano.

**name** `string`

Nome do banco de dados.

**description** `string`

Descrição do banco de dados.

**status** `string`

Status atual: `up`, `down` ou `building`.

**ram** `integer`

Memória alocada em MB.

**host** `string`

Endereço do host para conexão.

**port** `integer`

Porta de conexão.

**last\_snapshot** `string | null`

Data do último snapshot.

**offline\_since** `string | null`

Data desde quando está offline.

**created\_at** `string`

Data de criação.

**updated\_at** `string`

Data da última atualização.

**resource\_organization** `APIWorkspaceResourceOrganization`

A organização pessoal do usuário. Ela é privada para esse usuário e inclui as pastas e os favoritos usados
para organizar aplicações e bancos de dados. Os detalhes de alteração estão em
[Organização pessoal de recursos](https://docs.vertracloud.app/pt-br/api-reference/endpoint/users/resource-organization.md).

**Mostrar objeto**

**scope** `string`

Sempre `personal` nesta resposta.

**user\_id** `string`

ID do usuário dono desta organização.

**workspace\_id** `string | null`

Sempre `null` nesta resposta pessoal.

**folders** `APIWorkspaceResourceFolder[]`

Pastas pessoais. Cada pasta contém `id`, `name`, `color`, `position`, `resources`,
`created_at` e `updated_at`. `color` é `neutral`, `red`, `orange`, `yellow`, `green`,
`blue` ou `purple`.

**favorites** `APIWorkspaceFavorite[]`

Favoritos pessoais. Cada item contém `resource_type` (`application` ou `database`),
`resource_id`, `position` e `created_at`.

**connections** `APIUserConnection[]`

Contas OAuth vinculadas.

**Mostrar objeto**

**provider** `string`

Provedor OAuth (`discord`, `github`, `google`).

**username** `string`

Nome de usuário no provedor.

**created\_at** `string`

Data do vínculo.

```json Response theme={null}
{
  "response": {
    "id": "123456789012345678",
    "email": "user@example.com",
    "name": "user",
    "language": "pt-br",
    "plan": {
      "name": "pro",
      "expires_at": "2026-04-20T00:00:00.000Z",
      "duration": 30,
      "memory": {
        "limit": 1024,
        "used": 1024
      }
    },
    "applications": [
      {
        "id": "v111d4af8cd74272a284831fbae14a8v",
        "type": 2,
        "name": "My API",
        "description": "REST API with Express",
        "language": "javascript",
        "ram": 512,
        "status": "up",
        "subdomain": "my-api",
        "domains": [],
        "owner_plan": "pro",
        "owner_id": "123456789012345678",
        "main_file": "src/index.js",
        "version": "recommended",
        "start_command": "npm start",
        "last_snapshot": "2026-03-15T10:00:00.000Z",
        "offline_since": null,
        "created_at": "2026-01-15T15:51:47.234Z",
        "updated_at": "2026-03-19T15:06:41.449Z"
      }
    ],
    "databases": [
      {
        "id": "v41806687fe6488884a464d1dc06692v",
        "type": 1,
        "owner_plan": "pro",
        "name": "my-postgres",
        "description": "PostgreSQL Database",
        "status": "up",
        "ram": 1024,
        "host": "database.example.com",
        "port": 5432,
        "owner_id": "123456789012345678",
        "last_snapshot": "2026-03-18T00:00:00.000Z",
        "offline_since": null,
        "created_at": "2026-02-01T22:00:54.785Z",
        "updated_at": "2026-03-19T22:13:38.489Z"
      }
    ],
    "connections": [
      {
        "provider": "github",
        "username": "myuser",
        "created_at": "2026-01-15T15:51:47.234Z"
      },
      {
        "provider": "discord",
        "username": "myuser#1234",
        "created_at": "2026-01-15T15:51:47.234Z"
      }
    ],
    "created_at": "2026-01-15T01:26:04.784Z",
    "updated_at": "2026-03-19T22:10:31.220Z"
  }
}
```


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