Appearance
Update Bundle
FreshPATCH /v1/bundles/:id
Updates the metadata of an existing bundle. This endpoint changes display properties — it does not add or remove member feeds. To manage feed membership, use the Add/Remove Feed endpoints.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The bundle ID |
Request Body
All fields are optional. Include only the fields you want to update.
| Field | Type | Description |
|---|---|---|
name | string | New display name for the bundle |
description | string | New description text |
icon | string | New icon URL |
Code Example
js
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 name only
const response = await apiClient.patch('/bundles/bundle_xyz789', {
name: 'Top Technology Publications',
});
console.log('Updated name:', response.data.name);
// Update name and description
const fullUpdate = await apiClient.patch('/bundles/bundle_xyz789', {
name: 'Tech & Science',
description: 'Combined coverage of technology and science topics from major publications',
});
console.log(fullUpdate.data.name);
console.log(fullUpdate.data.description);Response
HTTP 200 with the updated bundle object.
json
{
"id": "bundle_xyz789",
"name": "Tech & Science",
"description": "Combined coverage of technology and science topics",
"icon": null,
"rss_feed_url": "https://rss.app/feeds/bundle-id.xml",
"feeds": ["feed_abc123", "feed_def456"],
"items": [ ... ]
}Error Responses
| Status | Meaning |
|---|---|
| 400 | Invalid field value |
| 401 | Authentication failed |
| 404 | Bundle not found |