Sign in
Admin

Trigger recrawl of links (admin)

Changed on

Trigger a recrawl of link bookmarks. You can filter by crawl status to target specific bookmarks (e.g., only failed ones) and by how recently they were modified. Optionally run AI inference after crawling. Requires admin role.

post/admin/jobs/trigger/recrawl

Request

  • Base URL: https://try.karakeep.app/api/v1
  • URL: https://try.karakeep.app/api/v1/admin/jobs/trigger/recrawl
  • Auth: HTTP bearer

Request body

crawlStatus'success' | 'failure' | 'pending' | 'all'

Filter bookmarks by their crawl status. Use 'failure' to retry only failed crawls.

runInferenceboolean

Whether to run AI inference after crawling.

modifiedWithinSecondsinteger

Only process bookmarks modified within this many seconds. Omit to process all matching bookmarks.

Example request

{
  "crawlStatus": "failure",
  "runInference": false,
  "modifiedWithinSeconds": 3600
}

Response

Recrawl jobs triggered successfully.

successboolean required

Whether the job was triggered successfully.

Changes