info:
  name: Update Dashboard Preferences
  type: http
  seq: 2
http:
  method: PUT
  url: '{{base_url}}/api/dashboard/preferences'
  auth: inherit
  body:
    type: json
    data: "{\n  \"library_id\": \"{{library_id}}\",\n  \"hidden_collections\": [\"not-started\"],\n  \"collection_order\": [\"recently-added\", \"continue-reading\", \"recently-read\"],\n  \"items_per_section\": 20\n}"
runtime:
  scripts:
  - type: tests
    code: "test(\"status must be 200 with valid request\", function() {\n    expect(res.status).to.eql(200);\n});"
docs: "Update dashboard preferences for the authenticated user.\n\n**Endpoint**: PUT /api/dashboard/preferences\n**Auth**: Required (Bearer token)\n\n## Request Body\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| library_id | string | Yes | Library UUID |\n| hidden_collections | array | No | Collection names to hide from dashboard |\n| collection_order | array | No | Collection names in custom display order |\n| items_per_section | int | No | Items to show per section (default: 20) |\n\n## Example Request\n\n```json\n{\n  \"library_id\": \"cc23c3a7-f8fb-451a-a78d-2a16df1b725a\",\n  \"hidden_collections\": [\"not-started\"],\n  \"collection_order\": [\"recently-added\", \"continue-reading\", \"recently-read\"],\n  \"items_per_section\": 20\n}\n```\n\n## Response\n\nReturns updated preferences object on success."