Run Tick Now

curl --request POST \
  --url https://api.example.com/api/v1/kg/tick/run-now \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "board_id": "<string>",
  "force_full_rebuild": false
}
'

{
  "scheduled_at": "<string>",
  "status": "<string>",
  "tick_id": "<string>"
}

kg-tick

Run Tick Now

Trigger the KG decay tick manually (idempotent — concurrent calls return 409 until the in-flight tick releases the advisory lock).

Body:

board_id (optional): scope the tick to a single board. When omitted, the tick runs globally (same scope as the cron schedule).
force_full_rebuild (optional, default false): zero out last_recomputed_at for nodes in scope BEFORE the tick, forcing recompute even of fresh nodes (ignores staleness threshold).

Returns 202 with tick_id immediately; the tick runs in background. Operator monitors progress via KGHealthView snapshot polling (30s).

Returns 409 when the advisory lock is already held by the cron OR another manual trigger.

POST

api

tick

run-now

Run Tick Now

curl --request POST \
  --url https://api.example.com/api/v1/kg/tick/run-now \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "board_id": "<string>",
  "force_full_rebuild": false
}
'

{
  "scheduled_at": "<string>",
  "status": "<string>",
  "tick_id": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

board_id

string | null

force_full_rebuild

boolean

default:false

Response

Successful Response

scheduled_at

string

required

status

string

required

tick_id

string

required

Last modified on May 17, 2026

Get Kg Queue Health Get My Permissions