Add movie to collection | Movie Knight Server

curl -X POST https://movieknight-server-7d8h.onrender.com/api/collections/66b0c1d2e3f4a5b6c7d8e9f0/movies \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "tmdbId": 27205
}'

{
  "ok": true,
  "data": {
    "id": "66b0c1d2e3f4a5b6c7d8e9f0",
    "name": "Favorites",
    "sort": "added_desc",
    "author": "moviefan",
    "movies": [
      {
        "id": 550,
        "title": "Fight Club",
        "addedAt": "2026-06-25T10:31:00.000Z",
        "genre_ids": [
          18
        ],
        "sortOrder": 0,
        "poster_path": "/pB8BM7pdSp6B6Ih7QZ4DrQ3PmJK.jpg",
        "releaseYear": 1999,
        "provider_ids": [
          8
        ],
        "release_date": "1999-10-15",
        "vote_average": 8.438
      },
      {
        "id": 27205,
        "title": "Inception",
        "addedAt": "2026-06-25T10:32:00.000Z",
        "genre_ids": [
          28,
          878,
          12
        ],
        "sortOrder": 0,
        "poster_path": "/oYuLEt3zVCKq57qu2F8dT7NIa6f.jpg",
        "releaseYear": 2010,
        "provider_ids": [
          9,
          1899
        ],
        "release_date": "2010-07-15",
        "vote_average": 8.369
      }
    ],
    "isOwner": true,
    "authorId": "66a1f2c4e5b3a1234567890a",
    "isPublic": false,
    "createdAt": "2026-06-25T10:30:00.000Z",
    "isDefault": true,
    "likesCount": 0,
    "movieCount": 2,
    "savesCount": 0
  }
}

What: Owner-only. Add a movie by TMDB id (idempotent: re-adding is a no-op). Hydrates the movie cache + filter facets from TMDB.

Auth: Bearer token required.

Path params: id (collection id).

Body (JSON):

Field	Type	Required	Description	Example
tmdbId	integer	yes	Numeric TMDB movie id (> 0).	`27205`

Returns: data = full (the updated collection + movies).

**What:** Owner-only. Add a movie by TMDB id (idempotent: re-adding is a no-op). Hydrates the movie cache + filter facets from TMDB. **Auth:** Bearer token required. **Path params:** `id` (collection id). **Body (JSON):** | Field | Type | Required | Description | Example | |---|---|---|---|---| | tmdbId | integer | yes | Numeric TMDB movie id (> 0). | `27205` | **Returns:** `data = full` (the updated collection + movies).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

collectionIdstringRequired

Collection id.

Request

This endpoint expects an object.

tmdbIdintegerRequired

Response

okboolean

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error