---
title: "Change, pause or turn on a feed"
method: PATCH
path: "/api/rss/{id}"
---

# Change, pause or turn on a feed

`PATCH /api/rss/{id}`

## Request

- Base URL: `https://postwire.io`
- URL: `https://postwire.io/api/rss/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `url` string: RSS 2.0, RSS 1.0 or Atom. http or https on ports 80, 443, 8080 or 8443; private, loopback, link-local and metadata addresses are refused (400 feed_url_blocked), also when a name resolves to one or a redirect points at one; at most 3 redirects, 8 seconds, 2 MB.
  - `platforms` string[]: Not YouTube or TikTok (video only). Instagram gets an item only when it has an image.
  - `template` string: {title}, {link}, {summary}. Fitted to each network's limit as that network counts it: the summary is shortened first, then the title; the link is never cut.
  - `interval_minutes` integer
  - `max_items` integer: New items posted per read, oldest first; the rest wait for the next read.
  - `mode` 'auto' | 'approval': approval: every new item waits for approval (paid plans).
  - `post_at` 'now' | 'next_slot'
  - `include_image` boolean
  - `ai_rewrite` boolean: Write each network's post with AI: one of the plan's AI drafts a day per item, never an extra charge; the template when they are used up.
  - `post_latest` boolean: Also post the newest item now. Otherwise the items already in the feed are recorded, not posted.
  - `enabled` boolean
  - `brand_id` string, uuid

## Response `200`

{ ok, feed }

## Other responses

- `404`: not_found

---

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