API 레퍼런스

사용자

프로젝트의 사용자를 관리합니다. 모든 엔드포인트는 secret key가 필요하며 서버 측 전용입니다.

서버 측 전용

모든 사용자 관리 엔드포인트는 sk_live_ secret key가 필요합니다. 클라이언트 측 코드에 절대 노출하지 마세요.

GET/v1/dashboard/users

사용자 목록

현재 프로젝트의 모든 사용자를 나열합니다. secret key가 필요합니다.

쿼리 파라미터

text

?limit=20&offset=0&search=john&projectId=proj_abc123

응답

json

{
  "users": [
    {
      "id": "usr_abc123",
      "email": "user@example.com",
      "displayName": "John Doe",
      "avatarUrl": null,
      "isBanned": false,
      "signInCount": 5,
      "lastSignInAt": "2026-01-15T10:30:00Z",
      "createdAt": "2026-01-01T00:00:00Z"
    }
  ],
  "total": 42
}

GET/v1/dashboard/users/:userId

사용자 조회

ID로 단일 사용자와 연결된 제공자 및 활성 세션을 가져옵니다.

응답

json

{
  "id": "usr_abc123",
  "email": "user@example.com",
  "displayName": "John Doe",
  "providers": ["google", "github"],
  "sessions": [...],
  "publicMetadata": {}
}

PATCH/v1/dashboard/users/:userId/ban

사용자 차단

사용자를 차단합니다. 모든 활성 세션을 취소하고 이후 로그인을 차단합니다.

응답

json

{ "success": true }

PATCH/v1/dashboard/users/:userId/unban

사용자 차단 해제

사용자의 차단을 해제하여 다시 로그인할 수 있게 합니다.

응답

json

{ "success": true }

DELETE/v1/dashboard/users/:userId

사용자 삭제

사용자와 모든 데이터를 영구 삭제합니다. 되돌릴 수 없습니다.

응답

json

{ "success": true }