Listar usuários
Liste todos os usuários da sua instância do Clowk com o endpoint REST GET /api/v1/users, autenticado pela secret key no header X-Clowk-Secret-Key.
GET /api/v1/users
Retorna todos os usuários da instância ligada à sua secret key.
Requisição
curl https://myapp.clowk.dev/api/v1/users \
-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 |
Resposta
200 — Sucesso
[
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"resource": "user",
"data": {
"email": "[email protected]",
"name": "Jane Doe",
"avatar_url": "https://lh3.googleusercontent.com/...",
"email_verified": true,
"providers": ["google"],
"created_at": "2026-03-20T10:30:00Z"
}
}
]401 — Não autorizado
{ "error": "Unauthorized" }Verificar token
Verifique um JWT do Clowk e obtenha o usuário logado com POST /api/v1/tokens/verify, e veja as claims do JWT, assinado em HS256 com sua secret key.
Buscar usuário
Busque um usuário do Clowk pelo UUID com GET /api/v1/users/:id usando sua secret key: email, nome, avatar, email verificado e providers OAuth.