---
title: "Update a view"
method: PATCH
path: "/v1/views/{id}"
tags: ["Views"]
---

# Update a view

`PATCH /v1/views/{id}`

## Request

- Base URL: `https://api.rumoro.dev`
- URL: `https://api.rumoro.dev/v1/views/{id}`
- Auth: HTTP bearer

Changes a view's name, description or filter. `filter` sets the full new filter.

## Path parameters

- `id` string, required: The view's id (vw_...).

## Request body

- object
  - `name` string
  - `description` string
  - `filter` object: Sets the full new filter.
    - `q` string: Searches post text and author names.
    - `keywordIds` string[]: Keeps matches of these keywords only.
    - `notKeywordIds` string[]: Keyword ids to exclude.
    - `keywordKinds` string[]: Keyword kinds to keep, out of brand, competitor and topic.
    - `groupIds` string[]: Limits to keywords from these groups (grp_...).
    - `notGroupIds` string[]: Hides matches from keywords that belong to these groups.
    - `platforms` string[]: Keeps posts from these platforms only.
    - `notPlatforms` string[]: Platforms to exclude.
    - `status` 'open' | 'ignored' | 'done': Keeps mentions with this status only (open, ignored or done).
    - `relevant` boolean: Filter on the classifier's verdict. true keeps relevant mentions, false the rest.
    - `minRelevance` integer: Minimum relevance score a mention needs.
    - `minConfidence` number: Keeps mentions whose classifier confidence is this value or higher.
    - `sentiments` string[]: Keeps mentions with these sentiments only.
    - `notSentiments` string[]: Hides these sentiments. Unscored mentions stay.
    - `intents` string[]: Keeps mentions tagged with one of these intents or topics.
    - `notIntents` string[]: Hides mentions with these tags.
    - `automated` boolean: true keeps posts that look machine-made. false keeps the others.
    - `languages` string[]: Keeps posts in these languages only, as ISO 639-1 codes.
    - `notLanguages` string[]: Leaves out posts in these languages. Posts with an unknown language are kept.
    - `tags` string[]: Keeps authors your workspace gave one of these tags.
    - `notTags` string[]: Leaves out authors with one of these tags.
    - `linkHosts` string[]: Keeps posts that link to one of these hosts or its subdomains.
    - `notLinkHosts` string[]: Leaves out posts that link to these hosts.
    - `minFollowers` integer: Keeps authors with this many followers or more. Unknown counts are left out.
    - `maxFollowers` integer: Keeps authors with this many followers or fewer. Unknown counts are left out.
    - `isReply` boolean: true keeps replies and comments. false keeps posts that are not replies.
    - `kind` 'post' | 'comment' | 'repository': Only posts (post) or only comments (comment: replies, comments and answers). repository (GitHub repository events) is accepted and matches nothing, since Rumoro does not collect them. Omitted: all.
    - `excludeAuthors` string[]: Leaves out these authors, given as display names, handles or profile links.
    - `ratings` integer[]: Keeps reviews with one of these star ratings. Posts that are not reviews are left out.
    - `notRatings` integer[]: Hides reviews with these star ratings. Other posts are not affected.
    - `minLikes` integer: Keeps posts with this many likes (upvotes, reactions) or more, counted when the post was collected. Posts without a like count are left out.
    - `minReposts` integer: Keeps posts with this many reposts (shares, retweets) or more, counted when the post was collected. Posts without a repost count are left out.
    - `minReplies` integer: Keeps posts with this many replies (comments) or more, counted when the post was collected. Posts without a reply count are left out.
    - `minQuotes` integer: Keeps posts with this many quotes or more, counted when the post was collected. Posts without a quote count are left out.
    - `minViews` integer: Keeps posts with this many views (plays) or more, counted when the post was collected. Posts without a view count are left out.
    - `minBookmarks` integer: Keeps posts with this many bookmarks (saves) or more, counted when the post was collected. Posts without a bookmark count are left out.
    - `anyOf` FilterGroup[]: Up to 10 OR'd groups (at least 1). A mention must meet every condition of some group, plus all other conditions, so the filter reads (other conditions) AND (group 1 OR group 2 ...). Groups take view filter fields (platforms, sentiments, intents, keywordKinds, the not lists and so on) but no nested anyOf.
      - `q` string: Searches post text and author names.
      - `keywordIds` string[]: Keeps matches of these keywords only.
      - `notKeywordIds` string[]: Keyword ids to exclude.
      - `keywordKinds` string[]: Keyword kinds to keep, out of brand, competitor and topic.
      - `groupIds` string[]: Limits to keywords from these groups (grp_...).
      - `notGroupIds` string[]: Hides matches from keywords that belong to these groups.
      - `platforms` string[]: Keeps posts from these platforms only.
      - `notPlatforms` string[]: Platforms to exclude.
      - `status` 'open' | 'ignored' | 'done': Keeps mentions with this status only (open, ignored or done).
      - `relevant` boolean: Filter on the classifier's verdict. true keeps relevant mentions, false the rest.
      - `minRelevance` integer: Minimum relevance score a mention needs.
      - `minConfidence` number: Keeps mentions whose classifier confidence is this value or higher.
      - `sentiments` string[]: Keeps mentions with these sentiments only.
      - `notSentiments` string[]: Hides these sentiments. Unscored mentions stay.
      - `intents` string[]: Keeps mentions tagged with one of these intents or topics.
      - `notIntents` string[]: Hides mentions with these tags.
      - `automated` boolean: true keeps posts that look machine-made. false keeps the others.
      - `languages` string[]: Keeps posts in these languages only, as ISO 639-1 codes.
      - `notLanguages` string[]: Leaves out posts in these languages. Posts with an unknown language are kept.
      - `tags` string[]: Keeps authors your workspace gave one of these tags.
      - `notTags` string[]: Leaves out authors with one of these tags.
      - `linkHosts` string[]: Keeps posts that link to one of these hosts or its subdomains.
      - `notLinkHosts` string[]: Leaves out posts that link to these hosts.
      - `minFollowers` integer: Keeps authors with this many followers or more. Unknown counts are left out.
      - `maxFollowers` integer: Keeps authors with this many followers or fewer. Unknown counts are left out.
      - `isReply` boolean: true keeps replies and comments. false keeps posts that are not replies.
      - `kind` 'post' | 'comment' | 'repository': Only posts (post) or only comments (comment: replies, comments and answers). repository (GitHub repository events) is accepted and matches nothing, since Rumoro does not collect them. Omitted: all.
      - `excludeAuthors` string[]: Leaves out these authors, given as display names, handles or profile links.
      - `ratings` integer[]: Keeps reviews with one of these star ratings. Posts that are not reviews are left out.
      - `notRatings` integer[]: Hides reviews with these star ratings. Other posts are not affected.
      - `minLikes` integer: Keeps posts with this many likes (upvotes, reactions) or more, counted when the post was collected. Posts without a like count are left out.
      - `minReposts` integer: Keeps posts with this many reposts (shares, retweets) or more, counted when the post was collected. Posts without a repost count are left out.
      - `minReplies` integer: Keeps posts with this many replies (comments) or more, counted when the post was collected. Posts without a reply count are left out.
      - `minQuotes` integer: Keeps posts with this many quotes or more, counted when the post was collected. Posts without a quote count are left out.
      - `minViews` integer: Keeps posts with this many views (plays) or more, counted when the post was collected. Posts without a view count are left out.
      - `minBookmarks` integer: Keeps posts with this many bookmarks (saves) or more, counted when the post was collected. Posts without a bookmark count are left out.

## Response `200`

The view after the change

- View
  - `id` string, required: The view's id (vw_...).
  - `name` string, required
  - `description` string, required
  - `filter` object, required
    - `q` string: Searches post text and author names.
    - `keywordIds` string[]: Keeps matches of these keywords only.
    - `notKeywordIds` string[]: Keyword ids to exclude.
    - `keywordKinds` string[]: Keyword kinds to keep, out of brand, competitor and topic.
    - `groupIds` string[]: Limits to keywords from these groups (grp_...).
    - `notGroupIds` string[]: Hides matches from keywords that belong to these groups.
    - `platforms` string[]: Keeps posts from these platforms only.
    - `notPlatforms` string[]: Platforms to exclude.
    - `status` 'open' | 'ignored' | 'done': Keeps mentions with this status only (open, ignored or done).
    - `relevant` boolean: Filter on the classifier's verdict. true keeps relevant mentions, false the rest.
    - `minRelevance` integer: Minimum relevance score a mention needs.
    - `minConfidence` number: Keeps mentions whose classifier confidence is this value or higher.
    - `sentiments` string[]: Keeps mentions with these sentiments only.
    - `notSentiments` string[]: Hides these sentiments. Unscored mentions stay.
    - `intents` string[]: Keeps mentions tagged with one of these intents or topics.
    - `notIntents` string[]: Hides mentions with these tags.
    - `automated` boolean: true keeps posts that look machine-made. false keeps the others.
    - `languages` string[]: Keeps posts in these languages only, as ISO 639-1 codes.
    - `notLanguages` string[]: Leaves out posts in these languages. Posts with an unknown language are kept.
    - `tags` string[]: Keeps authors your workspace gave one of these tags.
    - `notTags` string[]: Leaves out authors with one of these tags.
    - `linkHosts` string[]: Keeps posts that link to one of these hosts or its subdomains.
    - `notLinkHosts` string[]: Leaves out posts that link to these hosts.
    - `minFollowers` integer: Keeps authors with this many followers or more. Unknown counts are left out.
    - `maxFollowers` integer: Keeps authors with this many followers or fewer. Unknown counts are left out.
    - `isReply` boolean: true keeps replies and comments. false keeps posts that are not replies.
    - `kind` 'post' | 'comment' | 'repository': Only posts (post) or only comments (comment: replies, comments and answers). repository (GitHub repository events) is accepted and matches nothing, since Rumoro does not collect them. Omitted: all.
    - `excludeAuthors` string[]: Leaves out these authors, given as display names, handles or profile links.
    - `ratings` integer[]: Keeps reviews with one of these star ratings. Posts that are not reviews are left out.
    - `notRatings` integer[]: Hides reviews with these star ratings. Other posts are not affected.
    - `minLikes` integer: Keeps posts with this many likes (upvotes, reactions) or more, counted when the post was collected. Posts without a like count are left out.
    - `minReposts` integer: Keeps posts with this many reposts (shares, retweets) or more, counted when the post was collected. Posts without a repost count are left out.
    - `minReplies` integer: Keeps posts with this many replies (comments) or more, counted when the post was collected. Posts without a reply count are left out.
    - `minQuotes` integer: Keeps posts with this many quotes or more, counted when the post was collected. Posts without a quote count are left out.
    - `minViews` integer: Keeps posts with this many views (plays) or more, counted when the post was collected. Posts without a view count are left out.
    - `minBookmarks` integer: Keeps posts with this many bookmarks (saves) or more, counted when the post was collected. Posts without a bookmark count are left out.
    - `anyOf` FilterGroup[]: Up to 10 OR'd groups (at least 1). A mention must meet every condition of some group, plus all other conditions, so the filter reads (other conditions) AND (group 1 OR group 2 ...). Groups take view filter fields (platforms, sentiments, intents, keywordKinds, the not lists and so on) but no nested anyOf.
      - `q` string: Searches post text and author names.
      - `keywordIds` string[]: Keeps matches of these keywords only.
      - `notKeywordIds` string[]: Keyword ids to exclude.
      - `keywordKinds` string[]: Keyword kinds to keep, out of brand, competitor and topic.
      - `groupIds` string[]: Limits to keywords from these groups (grp_...).
      - `notGroupIds` string[]: Hides matches from keywords that belong to these groups.
      - `platforms` string[]: Keeps posts from these platforms only.
      - `notPlatforms` string[]: Platforms to exclude.
      - `status` 'open' | 'ignored' | 'done': Keeps mentions with this status only (open, ignored or done).
      - `relevant` boolean: Filter on the classifier's verdict. true keeps relevant mentions, false the rest.
      - `minRelevance` integer: Minimum relevance score a mention needs.
      - `minConfidence` number: Keeps mentions whose classifier confidence is this value or higher.
      - `sentiments` string[]: Keeps mentions with these sentiments only.
      - `notSentiments` string[]: Hides these sentiments. Unscored mentions stay.
      - `intents` string[]: Keeps mentions tagged with one of these intents or topics.
      - `notIntents` string[]: Hides mentions with these tags.
      - `automated` boolean: true keeps posts that look machine-made. false keeps the others.
      - `languages` string[]: Keeps posts in these languages only, as ISO 639-1 codes.
      - `notLanguages` string[]: Leaves out posts in these languages. Posts with an unknown language are kept.
      - `tags` string[]: Keeps authors your workspace gave one of these tags.
      - `notTags` string[]: Leaves out authors with one of these tags.
      - `linkHosts` string[]: Keeps posts that link to one of these hosts or its subdomains.
      - `notLinkHosts` string[]: Leaves out posts that link to these hosts.
      - `minFollowers` integer: Keeps authors with this many followers or more. Unknown counts are left out.
      - `maxFollowers` integer: Keeps authors with this many followers or fewer. Unknown counts are left out.
      - `isReply` boolean: true keeps replies and comments. false keeps posts that are not replies.
      - `kind` 'post' | 'comment' | 'repository': Only posts (post) or only comments (comment: replies, comments and answers). repository (GitHub repository events) is accepted and matches nothing, since Rumoro does not collect them. Omitted: all.
      - `excludeAuthors` string[]: Leaves out these authors, given as display names, handles or profile links.
      - `ratings` integer[]: Keeps reviews with one of these star ratings. Posts that are not reviews are left out.
      - `notRatings` integer[]: Hides reviews with these star ratings. Other posts are not affected.
      - `minLikes` integer: Keeps posts with this many likes (upvotes, reactions) or more, counted when the post was collected. Posts without a like count are left out.
      - `minReposts` integer: Keeps posts with this many reposts (shares, retweets) or more, counted when the post was collected. Posts without a repost count are left out.
      - `minReplies` integer: Keeps posts with this many replies (comments) or more, counted when the post was collected. Posts without a reply count are left out.
      - `minQuotes` integer: Keeps posts with this many quotes or more, counted when the post was collected. Posts without a quote count are left out.
      - `minViews` integer: Keeps posts with this many views (plays) or more, counted when the post was collected. Posts without a view count are left out.
      - `minBookmarks` integer: Keeps posts with this many bookmarks (saves) or more, counted when the post was collected. Posts without a bookmark count are left out.
  - `createdAt` string, required: UTC time in ISO 8601.
  - `updatedAt` string, required: UTC time in ISO 8601.

## Other responses

- `401`: The API key is missing or not valid
- `404`: This workspace has no view with this id
- `409`: This name is already used by a view (duplicate_view)

---

[API](https://skmtc.dev/rumoro/apis/rumoro-api.md) · [All operations](https://skmtc.dev/rumoro/apis/rumoro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rumoro/apis/rumoro-api/revisions/9ef63ea894d1?raw)