Listar sessões
curl --request GET \
--url https://api.vertracloud.app/v1/users/me/sessions \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/users/me/sessions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/users/me/sessions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/users/me/sessions"
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": "session-abc123",
"user_id": "user-123456789012345678",
"provider": "email",
"ip_address": "203.0.113.10",
"location": "Fortaleza, BR",
"device": "Chrome on macOS",
"expires_at": "2026-10-20T15:00:00.000Z",
"created_at": "2026-09-20T15:00:00.000Z",
"updated_at": "2026-09-21T09:00:00.000Z",
"is_current": true
}
]
}
Usuários
Listar sessões
Lista as sessões de login ativas do usuário autenticado.
GET
/
v1
/
users
/
me
/
sessions
Listar sessões
curl --request GET \
--url https://api.vertracloud.app/v1/users/me/sessions \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.vertracloud.app/v1/users/me/sessions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.vertracloud.app/v1/users/me/sessions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.vertracloud.app/v1/users/me/sessions"
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": "session-abc123",
"user_id": "user-123456789012345678",
"provider": "email",
"ip_address": "203.0.113.10",
"location": "Fortaleza, BR",
"device": "Chrome on macOS",
"expires_at": "2026-10-20T15:00:00.000Z",
"created_at": "2026-09-20T15:00:00.000Z",
"updated_at": "2026-09-21T09:00:00.000Z",
"is_current": true
}
]
}
Resposta
array
Um array de sessões ativas.
Mostrar Mostrar objeto
Mostrar Mostrar objeto
string
O ID da sessão.
string
O ID do usuário dono da sessão.
string
Como a sessão foi criada (por exemplo,
email, google, github).string | null
O endereço IP de onde a sessão foi criada, se conhecido.
string | null
Uma localização aproximada derivada do IP, se conhecida.
string | null
Uma descrição do dispositivo ou navegador, se conhecida.
string
Quando a sessão expira.
string
Quando a sessão foi criada.
string
Quando a sessão foi usada pela última vez.
boolean
Se esta é a sessão vinculada à credencial que faz a requisição atual.
{
"response": [
{
"id": "session-abc123",
"user_id": "user-123456789012345678",
"provider": "email",
"ip_address": "203.0.113.10",
"location": "Fortaleza, BR",
"device": "Chrome on macOS",
"expires_at": "2026-10-20T15:00:00.000Z",
"created_at": "2026-09-20T15:00:00.000Z",
"updated_at": "2026-09-21T09:00:00.000Z",
"is_current": true
}
]
}
Respostas de erro
string
O código de erro que indica o motivo da falha. Valores possíveis:
AUTH_TOKEN_MISSING,API_KEY_INVALID,SESSION_REVOKED: O cabeçalhoAuthorizationestá ausente, a chave de API é inválida ou a sessão do painel foi revogada (401).API_KEY_IP_DENIED,API_KEY_SCOPE_DENIED: A chave de API é usada a partir de um IP fora da sua lista de permissões, ou não tem o escopo que a rota exige (403).USER_NOT_FOUND: O usuário autenticado não foi encontrado.INTERNAL_SERVER_ERROR: Ocorreu um erro inesperado no servidor.
{
"code": "AUTH_TOKEN_MISSING"
}
Revogar uma sessão é uma ação exclusiva do painel — ela não é acessível com uma chave de API.
Última modificação em 28 de outubro de 2026