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

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

Parâmetros de caminho

ParâmetroTipoDescrição
idstringO 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 login
  • n — até n sessões simultâneas por usuário

Nesta página