Informações do usuário

curl --request GET \
  --url https://api.vertracloud.app/v1/users/me \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.vertracloud.app/v1/users/me', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vertracloud.app/v1/users/me"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "response": {
    "id": "123456789012345678",
    "email": "[email protected]",
    "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"
  }
}

GET

users

Informações do usuário

curl --request GET \
  --url https://api.vertracloud.app/v1/users/me \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.vertracloud.app/v1/users/me', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.vertracloud.app/v1/users/me"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "response": {
    "id": "123456789012345678",
    "email": "[email protected]",
    "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"
  }
}

Resposta

APIUserInfoResponse

Dados completos do usuário autenticado.

Mostrar Mostrar objeto

string

ID único do usuário (Snowflake).

string

E-mail do usuário.

string

Nome de exibição do usuário.

string

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

string

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

string

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

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 Mostrar objeto

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.

string

Data de expiração do plano.

integer

Duração do plano em dias.

APIUserPlanMemory

Uso de memória do plano.

Mostrar Mostrar objeto

integer

Limite de memória em MB.

integer

Memória em uso no momento, em MB.

APIApplication[]

Lista das aplicações do usuário.

Mostrar Mostrar objeto

string

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

integer

ID do cluster que hospeda a aplicação.

integer

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

string

Nome da aplicação.

string | undefined

Descrição da aplicação.

string

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

integer

Memória alocada em MB.

string

Status atual: up, down ou building.

string | null

Subdomínio da aplicação.

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.

string | null

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

string

Arquivo principal da aplicação.

string

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

string | null

Data do último snapshot.

string | null

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

string

Data de criação.

string

Data da última atualização.

APIDatabase[]

Lista dos bancos de dados do usuário.

Mostrar Mostrar objeto

string

ID único do banco de dados (Snowflake).

integer

ID do cluster.

integer

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

string | null

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

string

Nome do banco de dados.

string

Descrição do banco de dados.

string

Status atual: up, down ou building.

integer

Memória alocada em MB.

string

Endereço do host para conexão.

integer

Porta de conexão.

string | null

Data do último snapshot.

string | null

Data desde quando está offline.

string

Data de criação.

string

Data da última atualização.

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.

Mostrar Mostrar objeto

string

Sempre personal nesta resposta.

string

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

string | null

Sempre null nesta resposta pessoal.

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.

APIWorkspaceFavorite[]

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

APIUserConnection[]

Contas OAuth vinculadas.

Mostrar Mostrar objeto

string

Provedor OAuth (discord, github, google).

string

Nome de usuário no provedor.

string

Data do vínculo.

{
  "response": {
    "id": "123456789012345678",
    "email": "[email protected]",
    "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"
  }
}

Última modificação em 28 de outubro de 2026

Visão geral

Endpoints

Informações do usuário

Resposta

​Resposta

Resposta