Listar sessões

Liste todas as sessões ativas e revogadas da sua instância do Clowk com GET /api/v1/sessions, com provider, IP, geolocalização e horários de login.

GET /api/v1/sessions

Retorna todas as sessões (ativas e revogadas) da instância ligada à sua secret key, ordenadas pelo login mais recente.

Requisição

curl https://myapp.clowk.dev/api/v1/sessions \
  -H "X-Clowk-Secret-Key: sk_live_..."

Headers

HeaderObrigatórioDescrição
X-Clowk-Secret-KeySimA secret key da sua instância

Resposta

200 — Sucesso

[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "resource": "session",
    "data": {
      "session_id": "clk_session_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "user_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "provider": "google",
      "name": "Jane Doe",
      "email": "[email protected]",
      "ip_address": "203.0.113.42",
      "geo_data": {},
      "logged_in_at": "2026-03-20T10:30:00Z",
      "last_signin_at": "2026-03-20T10:30:00Z",
      "revoked_at": null,
      "active": true
    }
  }
]

Campos

CampoTipoDescrição
session_idstringIdentificador único da sessão (clk_session_UUID)
user_idstringUUID do usuário dono da sessão
providerstringProvedor de autenticação usado: google, github, twitter, password
namestringNome de exibição do usuário no momento do login
emailstringEmail do usuário no momento do login
ip_addressstringEndereço IP de onde a sessão foi criada
geo_dataobjectDados geográficos obtidos a partir do IP (se houver)
logged_in_atstringTimestamp ISO 8601 do primeiro login
last_signin_atstringTimestamp ISO 8601 do login mais recente
revoked_atstring | nullTimestamp ISO 8601 da revogação, ou null se ativa
activebooleantrue se a sessão não foi revogada

401 — Não autorizado

{ "error": "Unauthorized" }

Nesta página