Analytics

Request background analytics refresh

Queue a workspace analytics refresh and return immediately. Requests are deduplicated while a job is active, with a five-minute start cooldown. Optional ifStale=true reuses a collection updated within fifteen minutes; the dashboard uses it once on entry without restarting collection on filter changes. Recent eligible content is checked first through bounded continuations on a separate queue. During reliability incidents, collection can be paused: new requests return 503, analytics_refresh_unavailable and Retry-After: 60. Stored reports remain available. The same explicit refresh operation is available through get_analytics with refresh=true in MCP.

post/v1/analytics/refresh

Request

  • Base URL: https://api.postlake.dev
  • URL: https://api.postlake.dev/v1/analytics/refresh
  • Auth: bearerAuth (a scheme the document does not define)

Request body

ifStaleboolean

Reuse a recently updated collection instead of starting another job. Automatic-entry freshness interval is fifteen minutes; provider eligibility and cooldowns still apply.

Response

Queued, already active, or within the start cooldown

jobIdstring
state'queued' | 'running' | 'complete' | 'failed'
startedAtstring date-time
updatedAtstring date-time
postsinteger
errorsinteger
cursorstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.