info:
  name: Update Saved Filter
  type: http
  seq: 3
http:
  method: PUT
  url: '{{base_url}}/api/saved-filters/{{filter_id}}'
  auth: inherit
  body:
    type: json
    data: "{\n    \"name\": \"Updated Sci-Fi Books\",\n    \"resource_type\": \"media-items\",\n    \"filters\": {\n      \"genre_filter\": \"Science Fiction Fantasy\",\n      \"sort\": \"author ASC\",\n      \"year_min\": \"2000\"\n    }\n  }"
docs: "## Update Saved Filter\n\nUpdates an existing saved filter's name and/or filter criteria.\n\n**Method:** PUT\n\n**Endpoint:** /api/saved-filters/{filter_id}\n\n**Authentication:** Required (Bearer token)\n\n**Path Parameters:**\n- `filter_id` (string, required): UUID of the filter to update\n  - Must be a valid UUID\n  - Must belong to the authenticated user\n\n**Request Body:**\n```json\n{\n  \"name\": \"Updated Sci-Fi Books\",\n  \"resource_type\": \"media-items\",\n  \"filters\": {\n    \"genre_filter\": \"Science Fiction Fantasy\",\n    \"sort\": \"author ASC\",\n    \"year_min\": \"2000\",\n    \"year_max\": \"2024\"\n  }\n}\n```\n\n**Required Fields:**\n- `name` (string, required): New filter name\n  - Must be unique per user + resource type (excluding current filter)\n  - Maximum 100 characters\n- `resource_type` (string, required): Resource type (must match existing)\n  - Cannot change resource type after creation\n- `filters` (object, required): Updated filter criteria\n\
  \  - Replaces existing filters entirely\n\n**Response:**\n```json\n{\n  \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"name\": \"Updated Sci-Fi Books\",\n  \"resource_type\": \"media-items\",\n  \"filters\": {\n    \"genre_filter\": \"Science Fiction Fantasy\",\n    \"sort\": \"author ASC\",\n    \"year_min\": \"2000\",\n    \"year_max\": \"2024\"\n  },\n  \"created_at\": \"2024-03-20T12:00:00Z\",\n  \"updated_at\": \"2024-03-20T15:30:00Z\"\n}\n```\n\n**Status Codes:**\n- 200: Success - Filter updated successfully\n- 400: Bad Request - Invalid request body or filter ID\n- 401: Unauthorized - Invalid or missing authentication token\n- 404: Not Found - Filter doesn't exist or doesn't belong to user\n- 409: Conflict - New name conflicts with existing filter\n\n**Error Response Examples:**\n\nFilter not found:\n```json\n{\n  \"error\": \"filter not found or access denied\"\n}\n```\n\nDuplicate name:\n```json\n{\n  \"error\": \"filter with name 'Updated Sci-Fi Books' already exists\
  \ for this resource type\"\n}\n```\n\n**Example Usage:**\n```bash\ncurl -X PUT \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"name\": \"Updated Sci-Fi Books\",\n    \"resource_type\": \"media-items\",\n    \"filters\": {\n      \"genre_filter\": \"Science Fiction Fantasy\",\n      \"sort\": \"author ASC\",\n      \"year_min\": \"2000\"\n    }\n  }' \\\n  \"{{base_url}}/api/saved-filters/{{filter_id}}\"\n```\n\n**Important Notes:**\n- You can only update filters that belong to you\n- The `updated_at` timestamp is automatically updated\n- Cannot change the resource_type (it's immutable)\n- New name must not conflict with other filters you own for the same resource type\n- All filter fields are replaced entirely (partial updates not supported)"