---
title: "Revise collection filters"
method: PATCH
path: "/collections/{id}/filters"
tags: ["Collections"]
---

# Revise collection filters

`PATCH /collections/{id}/filters`

## Request

- Base URL: `https://studio.fintechstudios.com/api/v1`
- URL: `https://studio.fintechstudios.com/api/v1/collections/{id}/filters`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Merge filter changes into a collection: add/remove keywords, entities, exclusion terms and (stock portfolios) tickers; replace the query or regions. Anything not mentioned is kept — unlike PUT /collections/{id}, which replaces the whole filter object. Requires the `write` scope.

## Path parameters

- `id` string, required

## Request body

- object
  - `query` string
  - `keywords` string[]: Replaces the keyword list.
  - `add_keywords` string[]
  - `remove_keywords` string[]
  - `add_entities` object[]
  - `remove_entities` string[]: Entity names.
  - `add_exclude_terms` string[]
  - `remove_exclude_terms` string[]
  - `regions` string[], nullable
  - `add_tickers` string[]
  - `remove_tickers` string[]

## Response `200`

{ collection, invalid_tickers }

---

[API](https://skmtc.dev/fintechstudios/apis/fts-studio-api.md) · [All operations](https://skmtc.dev/fintechstudios/apis/fts-studio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fintechstudios/apis/fts-studio-api/revisions/4886597d1d96?raw)