Update collection (rename / publish / sort) | Movie Knight Server

curl -X PATCH https://movieknight-server-7d8h.onrender.com/api/collections/66b0c1d2e3f4a5b6c7d8e9f0 \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Classic Sci-Fi Collection",
  "sort": "title_asc",
  "isPublic": false
}'

{
  "ok": true,
  "data": {
    "id": "66b0c1d2e3f4a5b6c7d8e9f5",
    "name": "Classic Sci-Fi Collection",
    "sort": "title_asc",
    "author": "moviefan",
    "covers": [
      "https://image.tmdb.org/t/p/w500/8UlWHLMpgZm9bx6QYh0NFoq67TZ.jpg",
      "https://image.tmdb.org/t/p/w500/6FfCtAuVAW8XJjZ7eWeLibRLWTw.jpg"
    ],
    "isOwner": true,
    "isPublic": false,
    "movieIds": [
      "tt0083658",
      "tt0078748",
      "tt0062622"
    ],
    "createdAt": "2023-11-15T09:30:00.000Z",
    "isDefault": false,
    "likesCount": 42,
    "movieCount": 3,
    "savesCount": 15,
    "posterUrl": "https://image.tmdb.org/t/p/w500/8UlWHLMpgZm9bx6QYh0NFoq67TZ.jpg"
  }
}

What: Owner-only update for rename, publish/unpublish, and remembered sort. At least one recognised field required.

Auth: Bearer token required.

Body (JSON, all optional but at least one required):

Field	Type	Required	Description	Example
name	string	no	New title (trimmed, max 60). Rejected for default lists.	`Favorite Films`
isPublic	boolean	no	Publish (true) / unpublish (false). Allowed for default lists.	`true`
sort	string	no	One of: added_desc, added_asc, title_asc, title_desc, year_desc, year_asc.	`year_desc`

Returns: data = card. Setting a field to its current value is a valid no-op (still 200).

**What:** Owner-only update for rename, publish/unpublish, and remembered sort. At least one recognised field required. **Auth:** Bearer token required. **Body (JSON, all optional but at least one required):** | Field | Type | Required | Description | Example | |---|---|---|---|---| | name | string | no | New title (trimmed, max 60). Rejected for default lists. | `Favorite Films` | | isPublic | boolean | no | Publish (true) / unpublish (false). Allowed for default lists. | `true` | | sort | string | no | One of: added_desc, added_asc, title_asc, title_desc, year_desc, year_asc. | `year_desc` | **Returns:** `data = card`. Setting a field to its current value is a valid no-op (still 200).

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.

namestringOptional

sortstringOptional

isPublicbooleanOptional

Response

okboolean

dataobject

Errors

400

Bad Request Error

404

Not Found Error