info:
  name: Create Saved Filter
  type: http
  seq: 2
http:
  method: POST
  url: '{{base_url}}/api/saved-filters'
  auth: inherit
  body:
    type: json
    data: "{\n    \"name\": \"My Sci-Fi Books\",\n    \"resource_type\": \"media-items\",\n    \"filters\": {\n      \"genre_filter\": \"Science Fiction\",\n      \"sort\": \"title ASC\",\n      \"author_filter\": \"\"\n    }\n}"
docs: "## Create Saved Filter\n\nCreates a new saved filter for the authenticated user.\n\n**Method:** POST\n\n**Endpoint:** /api/saved-filters\n\n**Authentication:** Required (Bearer token)\n\n**Request Body:**\n```json\n{\n  \"name\": \"My Sci-Fi Books\",\n  \"resource_type\": \"media-items\",\n  \"filters\": {\n    \"genre_filter\": \"Science Fiction\",\n    \"sort\": \"title ASC\",\n    \"author_filter\": \"\",\n    \"series_filter\": \"\"\n  }\n}\n```\n\n**Required Fields:**\n- `name` (string, required): Filter name\n  - Must be unique per user + resource type combination\n  - Maximum 100 characters\n  - Cannot be empty\n- `resource_type` (string, required): Type of resource to filter\n  - Examples: \"media-items\", \"collections\", \"devices\"\n  - Must match valid resource types\n- `filters` (object, required): Key-value pairs of filter criteria\n  - Flexible structure - any valid filter fields\n  - Serialized as JSONB in database\n\n**Common Filter Fields for media-items:**\n- `search`:\
  \ General search term\n- `author_filter`: Filter by author name\n- `genre_filter`: Filter by genre\n- `series_filter`: Filter by series\n- `language_filter`: Filter by language\n- `year_min`: Minimum copyright year\n- `year_max`: Maximum copyright year\n- `has_cover`: Boolean for cover image\n- `sort`: Sort order (e.g., \"title ASC\", \"created_at DESC\")\n\n**Response:**\n```json\n{\n  \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"name\": \"My Sci-Fi Books\",\n  \"resource_type\": \"media-items\",\n  \"filters\": {\n    \"genre_filter\": \"Science Fiction\",\n    \"sort\": \"title ASC\"\n  },\n  \"created_at\": \"2024-03-20T12:00:00Z\",\n  \"updated_at\": \"2024-03-20T12:00:00Z\"\n}\n```\n\n**Status Codes:**\n- 201: Created - Filter successfully created\n- 400: Bad Request - Invalid request body or missing required fields\n- 401: Unauthorized - Invalid or missing authentication token\n- 409: Conflict - Filter with this name already exists for this resource type\n\n**Error Response\
  \ Examples:**\n\nDuplicate name error:\n```json\n{\n  \"error\": \"filter with name 'My Sci-Fi Books' already exists for this resource type\"\n}\n```\n\n**Example Usage:**\n```bash\ncurl -X POST \\\n  -H \"Authorization: Bearer YOUR_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"name\": \"My Sci-Fi Books\",\n    \"resource_type\": \"media-items\",\n    \"filters\": {\n      \"genre_filter\": \"Science Fiction\",\n      \"sort\": \"title ASC\"\n    }\n  }' \\\n  \"{{base_url}}/api/saved-filters\"\n```\n\n**Validation Rules:**\n- Name must be unique per user + resource type\n- Name cannot be empty or whitespace only\n- Resource type must be valid\n- Filters object must be provided (can be empty object {})"