Revogar sessão
Revogue uma sessão ativa do Clowk com DELETE /api/v1/sessions/:id, chame pelos SDKs e limite sessões simultâneas por usuário com max_concurrent_sessions.
DELETE /api/v1/sessions/:id
Revoga uma sessão ativa pelo session_id. Depois de revogada, a sessão não pode ser reativada. O JWT do usuário continua válido até expirar — este endpoint marca a sessão como revogada nos registros do Clowk.
Requisição
curl -X DELETE \
https://myapp.clowk.dev/api/v1/sessions/clk_session_a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
-H "X-Clowk-Secret-Key: sk_live_..."Headers
| Header | Obrigatório | Descrição |
|---|---|---|
X-Clowk-Secret-Key | Sim | A secret key da sua instância |
Parâmetros de caminho
| Parâmetro | Tipo | Descrição |
|---|---|---|
id | string | O valor de session_id (formato: clk_session_UUID) |
Resposta
200 — Revogada
{
"revoked": true,
"session_id": "clk_session_a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}401 — Não autorizado
{ "error": "Unauthorized" }404 — Não encontrada
{ "error": "Session not found" }422 — Já revogada
{ "error": "Session already revoked" }Uso no SDK
# Ruby
client.sessions.revoke("clk_session_a1b2c3d4-...")
# ou, de forma equivalente:
client.sessions.destroy("clk_session_a1b2c3d4-...")// JavaScript
await client.sessions.revoke('clk_session_a1b2c3d4-...')
// ou, de forma equivalente:
await client.sessions.destroy('clk_session_a1b2c3d4-...')Limite de sessões por instância
Você pode configurar max_concurrent_sessions em uma instância para revogar sessões antigas automaticamente quando uma nova é criada:
null— sessões simultâneas ilimitadas (padrão)1— uma sessão ativa por usuário; a mais antiga é revogada quando acontece um novo loginn— aténsessões simultâneas por usuário
Pesquisar sessões
Busque sessões do Clowk com GET /api/v1/sessions/search, filtrando por provider, email, endereço IP e datas de login com wildcards, negação e OR.
Operadores de pesquisa
Referência da linguagem de busca do Clowk usada na API de busca de usuários e sessões: correspondência exata, wildcards, negação, OR e comparação de datas.