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.

GET /api/v1/users/:id

Busca um usuário pelo UUID. Retorna só usuários da instância ligada à sua secret key.

Requisição

curl https://myapp.clowk.dev/api/v1/users/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
idstringUUID do usuário

Resposta

200 — Usuário encontrado

{
  "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", "github"],
    "created_at": "2026-03-20T10:30:00Z"
  }
}
CampoTipoDescrição
idstringUUID do usuário (nível superior)
resourcestringSempre "user"
data.emailstringEmail do usuário
data.namestringNome de exibição
data.avatar_urlstring | nullURL da foto de perfil
data.email_verifiedbooleanSe o email foi verificado
data.providersstring[]Lista de provedores OAuth conectados
data.created_atstringTimestamp ISO 8601

401 — Não autorizado

{
  "error": "Missing secret key"
}

404 — Usuário não encontrado

{
  "error": "User not found"
}

Retorna 404 se o usuário não existe ou pertence a outra instância.

Nesta página