Sign in
Admin

Trigger AI inference on bookmarks (admin)

Changed on

Trigger AI inference (tagging or summarization) on bookmarks. You can filter by status and by how recently bookmarks were modified. Requires admin role.

post/admin/jobs/trigger/inference

Request

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

Request body

type'tag' | 'summarize' required

The type of inference to run: 'tag' for AI tagging, 'summarize' for AI summarization.

status'success' | 'failure' | 'pending' | 'all'

Filter bookmarks by their inference status. Use 'failure' to retry only failed ones.

modifiedWithinSecondsinteger

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

Example request

{
  "type": "tag",
  "status": "failure",
  "modifiedWithinSeconds": 3600
}

Response

Inference jobs triggered successfully.

successboolean required

Whether the job was triggered successfully.

Changes