Sign in
latestOpenAPI 3.0.32026-08-227451,2751.8 MB

d0fc0114da66

AnalysisCache

Persist a new cached analysis entry

Creates a new analysis_cache row for the given workspace + scope. Cache rows are immutable: each refresh writes a new row, and the read path returns the latest by created_time. The server generates analysis_cache_id and created_time — they should be omitted from the request body. Internal endpoint, server-to-server only (API key with write scope on ai_analysis).

post/workspaces/{workspace_id}/analysisCache

Path parameters

workspace_idstring required

ID of the workspace

Request body

analysis_cache_idstring

Unique ID for this cache row

workspace_idstring
scope_type'test' | 'plan' | 'workspace'

Cache scope level

scope_keystring

Scope identifier — test_invariant_id, plan_id, or composite for workspace

created_timeinteger

Unix epoch ms — when this cache entry was written

reference_summary_mdstring

Terse, information-dense markdown that the agent reads into its context. Cap is a token-budget guardrail — the cache writer should produce summaries comfortably under this limit.

coverage_through_timeinteger

Unix epoch ms — latest run included in this cache

coverage_from_timeinteger

Unix epoch ms — earliest run included in this cache

entity_modified_timeinteger

Unix epoch ms — last modification time of the focal entity (test or plan) at the moment the cache was written. Lets consumers detect edits that happened after this cache entry and decide whether to refresh. Populated for test and plan scope; omitted for workspace scope.

Response

Cache row persisted

analysis_cache_idstring

Unique ID for this cache row

workspace_idstring
scope_type'test' | 'plan' | 'workspace'

Cache scope level

scope_keystring

Scope identifier — test_invariant_id, plan_id, or composite for workspace

created_timeinteger

Unix epoch ms — when this cache entry was written

reference_summary_mdstring

Terse, information-dense markdown that the agent reads into its context. Cap is a token-budget guardrail — the cache writer should produce summaries comfortably under this limit.

coverage_through_timeinteger

Unix epoch ms — latest run included in this cache

coverage_from_timeinteger

Unix epoch ms — earliest run included in this cache

entity_modified_timeinteger

Unix epoch ms — last modification time of the focal entity (test or plan) at the moment the cache was written. Lets consumers detect edits that happened after this cache entry and decide whether to refresh. Populated for test and plan scope; omitted for workspace scope.