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

curl -X PATCH https://{{baseurl}}/api/collections/%7BcollectionId} \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "name": "Classic Sci-Fi Collection",
  "sort": "year_desc",
  "isPublic": true
}'

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

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

Request

This endpoint expects an object.

namestringRequired

sortstringRequired

isPublicbooleanRequired

Response

okboolean

dataobject

Errors

400

Bad Request Error

404

Not Found Error