Feeds

Selector-based writes with dry-run preview

Preview changes to matching sources, entries, or collections. Default dry_run:true returns would_affect, sample, and commit_token without changing them. Commit by sending the same op and commit_token; retries replay the recorded result. Explicit dry_run:false applies immediately. sources.move needs set.collection; sources.rename needs set.title; collections.create/rename need set.name. Collections rename/delete need exactly one where.collection. Use manage_collections for direct collection CRUD. Check partial and each outcome after committing.

POST

https://api.smry.ai

feeds

mutate

Selector-based writes with dry-run preview

curl --request POST \
  --url https://api.smry.ai/v1/feeds/mutate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "op": "collections.create"
}
'

import requests

url = "https://api.smry.ai/v1/feeds/mutate"

payload = { "op": "collections.create" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({op: 'collections.create'})
};

fetch('https://api.smry.ai/v1/feeds/mutate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "object": "feed_mutation_preview",
  "op": "<string>",
  "would_affect": 123,
  "sample": [
    "<string>"
  ],
  "commit_token": "<string>",
  "expires_in_seconds": 123
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

Authorizations

Authorization

string

header

required

Clerk OAuth 2.0 Authorization Code flow with PKCE. Request the minimum scope required by the operation.

Body

application/json

required

sources.* use where.source or where.collection, never entry filters. entries.* use the full where predicate. collections.rename/delete select one where.collection; collections.create uses set.name.

Allowed value: "sources.unfollow"

where

object

Entry selection predicate: fields AND together; omit a field to not filter on it. Source queries/mutations accept only collection and source; use query having for source-health filters.

Hide child attributes

where.discovered_after

string

When smry first saw the entry. Backfill makes old posts look new here, so use it for diffs, not for "what's new". Relative window ("7d", "36h", "45m", "2w"), "now", or ISO date.

Required string length: 1 - 64

where.discovered_before

string

Relative window ("7d", "36h", "45m", "2w"), "now", or ISO date.

Required string length: 1 - 64

where.published_after

string

When the source published the entry (entries with no publish date are excluded; use top-level since to include them). Relative window ("7d", "36h", "45m", "2w"), "now", or ISO date.

Required string length: 1 - 64

where.published_before

string

Relative window ("7d", "36h", "45m", "2w"), "now", or ISO date.

Required string length: 1 - 64

where.collection

(integer | string)[]

Required array length: 1 - 20 elements

A collection id or its exact name.

Required range: x >= 1

where.source

object

Hide child attributes

where.source.include

(integer | string)[]

Required array length: 1 - 100 elements

A source id (from any v2 response) or its title. Reads also accept a fragment that matches exactly one title.

Required range: x >= 1

where.source.exclude

(integer | string)[]

Required array length: 1 - 100 elements

A source id (from any v2 response) or its title. Reads also accept a fragment that matches exactly one title.

Required range: x >= 1

where.unread

boolean

true = only unread entries, false = only read entries.

where.classification

object

The Collection filter's binary delivery decision and optional underlying assessment. Requires exactly one Collection.

Hide child attributes

where.classification.decision

required

Allowed value: "include"

where.classification.assessment

Allowed value: "relevant"

where.match

string

Case-insensitive text match over title and summary. "a OR b" matches either.

Required string length: 1 - 500

set

object

Hide child attributes

set.collection

Required for sources.move: destination collection id or name.

Required range: x >= 1

set.title

string

Required for sources.rename: the new source title.

Required string length: 1 - 300

set.name

string

Required for collections.create and collections.rename: the collection name.

Required string length: 1 - 100

dry_run

boolean

Default true: preview affected records and return a commit_token. Explicit false applies immediately; prefer preview then commit_token for agent workflows.

commit_token

string

From a dry run. Single-use and idempotent: resending after a network failure replays the recorded outcome.

Maximum string length: 100

Response

Selector-based writes with dry-run preview. The operation succeeded.

Option 1
Option 2

Selector-based writes with dry-run preview. The operation succeeded.

object

string

required

Allowed value: "feed_mutation_preview"

string

required

would_affect

integer

required

sample

string[]

required

commit_token

string

required

expires_in_seconds

integer

required

Last modified on September 13, 2026

Selector-based writes with dry-run preview

curl --request POST \
  --url https://api.smry.ai/v1/feeds/mutate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "op": "collections.create"
}
'

import requests

url = "https://api.smry.ai/v1/feeds/mutate"

payload = { "op": "collections.create" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({op: 'collections.create'})
};

fetch('https://api.smry.ai/v1/feeds/mutate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "object": "feed_mutation_preview",
  "op": "<string>",
  "would_affect": 123,
  "sample": [
    "<string>"
  ],
  "commit_token": "<string>",
  "expires_in_seconds": 123
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

Overview

Account

Articles

Library

Feeds

Collections

Consumers

Monitors

Selector-based writes with dry-run preview

Authorizations

Body

Response