Opsmemory API Reference

Field	Value
Source spec	`opsmemory/openapi/v1.json`
OpenAPI version	`3.1.1`
API version	`1.0.0`
Operations	8
Path filter	All paths

Operations

`GET /api/v1/buildinfo`

API alias for /buildinfo.json (same payload).

Property	Value
Operation ID	`StellaOpsBuildInfoApi`
Tags	`StellaOps.OpsMemory.WebService`
Auth	Not declared
Request body	-

Responses:

Status	Description	Content types
`200`	OK	-

`GET /api/v1/opsmemory/decisions`

Queries stored security decisions with optional filters by CVE ID, component prefix, action type, and outcome status. Supports cursor-based pagination.

Property	Value
Operation ID	`QueryDecisions`
Tags	`OpsMemory`
Auth	Not declared
Request body	-

Parameters:

Name	In	Required
`action`	`query`	no
`componentPrefix`	`query`	no
`cursor`	`query`	no
`cveId`	`query`	no
`outcomeStatus`	`query`	no
`pageSize`	`query`	no
`tenantId`	`query`	no

Responses:

Status	Description	Content types
`200`	OK	`application/json`
`400`	Bad Request	`application/json`

`POST /api/v1/opsmemory/decisions`

Records a security decision (accept, suppress, mitigate, escalate) for a CVE and component combination. The decision is stored with situational context for future playbook learning and similarity matching. Returns 201 Created with the new memory ID.

Property	Value
Operation ID	`RecordDecision`
Tags	`OpsMemory`
Auth	Not declared
Request body	`application/json`

Responses:

Status	Description	Content types
`201`	Created	`application/json`
`400`	Bad Request	`application/json`

`GET /api/v1/opsmemory/decisions/{memoryId}`

Returns the full decision record for a specific memory ID including situational context, decision details, mitigation information, and outcome if recorded. Returns 404 if not found.

Property	Value
Operation ID	`GetDecision`
Tags	`OpsMemory`
Auth	Not declared
Request body	-

Parameters:

Name	In	Required	Description
`memoryId`	`path`	yes
`tenantId`	`query`	no

Responses:

Status	Description	Content types
`200`	OK	`application/json`
`400`	Bad Request	`application/json`
`404`	Not Found	-

`POST /api/v1/opsmemory/decisions/{memoryId}/outcome`

Records the observed outcome of a previously stored security decision, capturing resolution time, actual impact, lessons learned, and whether the decision would be repeated. Returns 200 with the updated memory ID.

Property	Value
Operation ID	`RecordOutcome`
Tags	`OpsMemory`
Auth	Not declared
Request body	`application/json`

Parameters:

Name	In	Required	Description
`memoryId`	`path`	yes
`tenantId`	`query`	no

Responses:

Status	Description	Content types
`200`	OK	`application/json`
`400`	Bad Request	`application/json`
`404`	Not Found	-

`GET /api/v1/opsmemory/stats`

Returns aggregated decision statistics for the tenant including total decision count, decisions with recorded outcomes, and overall success rate.

Property	Value
Operation ID	`GetOpsMemoryStats`
Tags	`OpsMemory`
Auth	Not declared
Request body	-

Parameters:

Name	In	Required	Description
`tenantId`	`query`	no

Responses:

Status	Description	Content types
`200`	OK	`application/json`
`400`	Bad Request	`application/json`

`GET /api/v1/opsmemory/suggestions`

Returns ranked playbook suggestions for a given situational context by matching against historical decisions using similarity scoring. Each suggestion includes confidence, success rate, and evidence from past decisions.

Property	Value
Operation ID	`GetPlaybookSuggestions`
Tags	`OpsMemory`
Auth	Not declared
Request body	-

Parameters:

Name	In	Required
`componentPurl`	`query`	no
`cveId`	`query`	no
`cvssScore`	`query`	no
`epssScore`	`query`	no
`limit`	`query`	no
`reachability`	`query`	no
`severity`	`query`	no
`tenantId`	`query`	no

Responses:

Status	Description	Content types
`200`	OK	`application/json`
`400`	Bad Request	`application/json`

`GET /buildinfo.json`

Image build provenance (module, gitSha, gitCommitTime, imageBuiltAt, branch) for drift detection.

Property	Value
Operation ID	`StellaOpsBuildInfoFile`
Tags	`StellaOps.OpsMemory.WebService`
Auth	Not declared
Request body	-

Responses:

Status	Description	Content types
`200`	OK	-