Sign in
Feeds

Create a new feed

Changed on

Create a new RSS feed subscription. The feed will be periodically fetched and matching items will be imported as bookmarks.

post/feeds

Request

  • Base URL: https://try.karakeep.app/api/v1
  • URL: https://try.karakeep.app/api/v1/feeds
  • Auth: HTTP bearer

Request body

namestring required
urlstring uri required
enabledboolean required
importTagsboolean

Response

The created feed.

idstring required
namestring required
urlstring uri required
enabledboolean required
importTagsboolean required
lastFetchedStatus'success' | 'failure' | 'pending' | 'null' nullable required
lastFetchedAtstring nullable required

ISO 8601 timestamp of the last fetch attempt, or null if never fetched.

lastSuccessfulFetchAtstring nullable required

ISO 8601 timestamp of the last successful fetch, or null if the feed has never been fetched successfully.

Example response

{
  "lastFetchedAt": "2025-01-15T12:00:00.000Z",
  "lastSuccessfulFetchAt": "2025-01-15T12:00:00.000Z"
}

Changes

  • 69b85ed2cdbfRevision changes
    • warning

      added the new undefined enum value to the response property for the response status

  • 637c38fad1bcRevision changes
    • info

      added the required property to the response with the status