Update Feed

Fresh

Update a Feed

PATCH /v1/feeds/:id

Updates the metadata of an existing feed. This endpoint changes feed display properties — it does not change what content is fetched or how the feed is monitored.

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	The feed ID

Request Body

All fields are optional. Include only the fields you want to change.

Field	Type	Description
title	string	New display title for the feed
description	string	New description text
icon	string	New icon URL

Code Example

const axios = require('axios');

const apiClient = axios.create({
  baseURL: 'https://api.rss.app/v1',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY:YOUR_API_SECRET',
    'Content-Type': 'application/json',
  },
});

// Update title only
const response = await apiClient.patch('/feeds/feed_abc123', {
  title: 'TechCrunch — Technology News',
});

console.log('Updated title:', response.data.title);

// Update multiple fields
const fullUpdate = await apiClient.patch('/feeds/feed_abc123', {
  title: 'Tech News Daily',
  description: 'Curated technology news and analysis',
});

console.log(fullUpdate.data.title);
console.log(fullUpdate.data.description);

Response

HTTP 200 with the updated feed object.

Error Responses

Status	Meaning
400	Invalid field value
401	Authentication failed
404	Feed not found

---

Update Feed Settings

PATCH /v1/feeds/:id/settings

Updates the configuration settings for a feed.

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	The feed ID

Request Body

Field	Type	Description
customAuthor	string or null	Override author attribution on all items. Pass null to reset to original authors.

Code Example

// Set a custom author
const response = await apiClient.patch('/feeds/feed_abc123/settings', {
  customAuthor: 'Editorial Team',
});

console.log('Custom author set:', response.data.customAuthor);

// Remove the custom author (revert to original source authors)
const reset = await apiClient.patch('/feeds/feed_abc123/settings', {
  customAuthor: null,
});

console.log('Custom author cleared:', reset.data.customAuthor); // null

The customAuthor setting replaces the authors field on every item in the feed with the provided string. This is useful when you want to attribute all content to a consistent editorial identity rather than the original article author.

Setting customAuthor to null removes the override and restores the original author data from the source.

Response

HTTP 200 with the updated settings object:

{
  "customAuthor": "Editorial Team"
}

Error Responses

Status	Meaning
400	Invalid field value
401	Authentication failed
404	Feed not found