Signup | Movie Knight Server

curl -X POST https://{{baseurl}}/api/auth/signup \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Movie Fan",
  "email": "moviefan@example.com",
  "password": "secret123",
  "username": "moviefan",
  "dateOfBirth": "1999-05-20"
}'

{
  "ok": true,
  "data": {
    "user": {
      "id": "66a1f2c4e5b3a1234567890a",
      "bio": "",
      "name": "Movie Fan",
      "email": "moviefan@example.com",
      "badges": [],
      "aiUsage": {
        "used": 0,
        "limit": 5,
        "remaining": 5
      },
      "username": "moviefan",
      "createdAt": "2026-06-25T10:30:00.000Z",
      "dateOfBirth": "1999-05-20T00:00:00.000Z"
    },
    "token": "{{supabase_service_role_api_key_19n1}}"
  }
}

What: Create an account, seed the 3 default collections (Favorites, Already Watched, Watchlist), and return a JWT plus the safe user.

Auth: None.

Body (JSON):

Field	Type	Required	Description	Example
name	string	yes	Display name.	`Movie Fan`
email	string	yes	Must match a basic email pattern; stored lowercased.	`moviefan@example.com`
username	string	yes	Unique; trimmed, case-sensitive.	`moviefan`
password	string	yes	Minimum 6 characters.	`secret123`
dateOfBirth	string (date)	yes	Any value parseable by `Date` (ISO recommended).	`1999-05-20`

Returns: data = { token, user }. user never includes passwordHash.

**What:** Create an account, seed the 3 default collections (Favorites, Already Watched, Watchlist), and return a JWT plus the safe user. **Auth:** None. **Body (JSON):** | Field | Type | Required | Description | Example | |---|---|---|---|---| | name | string | yes | Display name. | `Movie Fan` | | email | string | yes | Must match a basic email pattern; stored lowercased. | `moviefan@example.com` | | username | string | yes | Unique; trimmed, case-sensitive. | `moviefan` | | password | string | yes | Minimum 6 characters. | `secret123` | | dateOfBirth | string (date) | yes | Any value parseable by `Date` (ISO recommended). | `1999-05-20` | **Returns:** `data = { token, user }`. `user` never includes `passwordHash`.

Authentication

Request

Response

Errors