analyses

Start a Memory Analysis run

Kick off a background analysis run.

Returns 202 with the new run_id. The pipeline runs in asyncio.create_task(run_analysis_task); clients poll GET /analyses/{run_id} for status transitions.

Error mapping (delegated to global handler via custom exceptions):

  • 422 ValidationError — context exceeds the #1244 run-size cap (checked BEFORE the idempotency guard, so an over-cap context with a run already in flight gets 422, not the 409+run_id hint; cancel/poll that run via the list endpoint).
  • 409 ConflictError — a prior run is still running for the same (workspace, context). Body carries the existing run_id.
  • 422 ValidationError — BYOK key missing (orchestrator's pre-flight) OR caller-supplied model_id does not exist.
post/api/v1/contexts/{context_id}/analyses

Request

  • Base URL: https://memory.kagura-ai.com (the document declares no server; this is the origin it was published from)
  • URL: https://memory.kagura-ai.com/api/v1/contexts/{context_id}/analyses
  • Auth: none declared

Path parameters

context_idstring uuid required

Headers

authorizationstring nullable

Request body

fromstring nullable
tostring nullable
typesstring[] nullable
tagsstring[] nullable
min_importancenumber nullable
querystring nullable
model_idinteger nullable

Response

Successful Response

run_idunknown required
statusunknown required
started_atunknown required

Changes

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