---
title: "Creates a new saved filter"
method: PUT
path: "/filters"
tags: ["filter"]
---

# Creates a new saved filter

`PUT /filters`

Creates a new saved filter

## Response `201`

The Saved Filter

- ModelsSavedFilter
  - `created` string — A timestamp when this filter was created. You cannot change this value.
  - `description` string — The description of the filter
  - `filters` ModelsTaskCollection
    - `filter` string — The filter query to match tasks by. Check out https://vikunja.io/docs/filters for a full explanation.
    - `filter_include_nulls` boolean — If set to true, the result will also include null values
    - `order_by` string[] — The query parameter to order the items by. This can be either asc or desc, with asc being the default.
    - `s` string
    - `sort_by` string[] — The query parameter to sort by. This is for ex. done, priority, etc.
  - `id` integer — The unique numeric id of this saved filter
  - `is_favorite` boolean — True if the filter is a favorite. Favorite filters show up in a separate parent project together with favorite projects.
  - `owner` UserUser
    - `bot_owner_id` integer — BotOwnerID is the ID of the owning (human) user if this user is a bot. A non-zero value means this user is a bot and cannot authenticate via password.
    - `created` string — A timestamp when this task was created. You cannot change this value.
    - `email` string — The user's email address.
    - `id` integer — The unique, numeric id of this user.
    - `name` string — The full name of the user.
    - `updated` string — A timestamp when this task was last updated. You cannot change this value.
    - `username` string — The username of the user. Is always unique.
  - `title` string — The title of the filter.
  - `updated` string — A timestamp when this filter was last updated. You cannot change this value.

## Other responses

- `403` — The user does not have access to that saved filter.
- `500` — Internal error

---

[API](https://skmtc.net/go-vikunja/apis/vikunja-api.md) · [All operations](https://skmtc.net/go-vikunja/apis/vikunja-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/go-vikunja/vikunja-api/revisions/feb3f68bbdf1/schema)