List engrams
Filter by any engram field named in the parameters. Ranges use brackets: GET /v1/engrams?heatShare[lte]=0.05&strength[lt]=2 lists the engrams with little recent use and a weak cluster.
See the Engrams guide for complete request examples, field meanings and cursor handling.
/v1/engramsStable public ids in ascending order. Select a Workspace assigned to the key; it can be omitted only when the key has exactly one assignment. A person must name a Workspace they can access. Filters narrow the list; an engram without a filtered field never matches it. Follow nextPageUrl with the same Workspace, filters and limit; a new fold invalidates the list snapshot.
Authentication
Send your API key with the AugentaKey authorization scheme. Workspace requests must target a Workspace assigned to the key. See authentication and permissions.
Request
Parameters
workspacestringoptionalquery parameter. One assigned Workspace. Required for keys with multiple assignments; inferred for one.
pagestringoptionalquery parameter. The previous memory cursor, with the same selection. Follow the returned nextPageUrl unchanged.
Min length: 1Max length: 131072
strength[gt]number | nulloptionalquery parameter. Engram strength greater than this value.
Minimum: 0
memoryClassstringoptionalquery parameter. Only engrams of this memory class.
Min length: 1Max length: 256
labelstringoptionalquery parameter. Only engrams whose label has this term, ignoring case. A term can be two words ("exact scan").
Min length: 1Max length: 256
labelSupport[gt]number | nulloptionalquery parameter. Label support greater than this value.
Minimum: 0Maximum: 1
labelSupport[gte]number | nulloptionalquery parameter. Label support at least this value.
Minimum: 0Maximum: 1
labelSupport[lt]number | nulloptionalquery parameter. Label support less than this value.
Minimum: 0Maximum: 1
labelSupport[lte]number | nulloptionalquery parameter. Label support at most this value.
Minimum: 0Maximum: 1
Responses
One bounded page.
objectstringalways presentAllowed: "list"
urlstringalways presentThe list's own path.
dataarrayalways presentShow item fields
objectstringalways presentThe resource type. Always engram. Use this field to recognize Engram objects in API results.
Allowed: "engram"
idstringalways presentThe ID Augenta assigns to this Engram, starting with eng_. In a Workspace, put this value in GET /v1/engrams/{id} to retrieve it. A one-shot Engram exists only in that result and has no standalone lookup URL. See Engram IDs for examples and how IDs behave as memory changes.
summarystring | nullconditionalA readable summary of the Claims grouped in this Engram. Use it to display what the Engram is about. It can change as Claims or summary text change. Null when no summary is available; omitted when summaries:false is requested.
labelstring | nullconditionalA short topic label, such as releases · rollback, for display in lists. Augenta chooses terms that distinguish this Engram from others in the same Workspace or one-shot result. An empty string means no terms qualified; null means a label is unavailable. Omitted with summaries:false.
labelSupportnumber | nullconditionalHow widely the label's terms appear in this Engram's Claims. For each term, Augenta calculates the share of Claims containing it, then averages those shares. Ranges from 0 to 1: at 1, every label term appears in every Claim. It is not confidence in the label's accuracy. Null when unavailable; omitted with summaries:false.
Minimum: 0Maximum: 1
memoryClassstring | nullalways presentThe kind of content Augenta identified. Common values are semantic for facts, episodic for past events, procedural for how-to knowledge and prospective for commitments or future tasks. This does not select one-shot or Workspace mode. Null when unavailable.
statusstring | nullalways presentThe Engram's recorded state. weakened means its strength fell below half its recorded peak; it can return to active when its strength recovers. This describes retained memory, not Experience processing progress. Null when unavailable.
Allowed: "active""weakened"null
strengthnumber | nullalways presentA score describing the structural support for this Engram's group of Claims. Larger values indicate a stronger grouping under the memory process's scoring rules; this is not a probability or a measure of factual correctness. One-shot scores describe its last rebuild; Workspace scores come from its persisted memory history. Compare within the same memory, not across modes. Null when unavailable.
claimCountintegeralways presentThe total number of Claims currently in this Engram. Use it to show the size of the group. It can exceed claims.data.length because only one page may be loaded; Claims that have left the Engram are excluded.
Minimum: 0
claimTokenCountinteger | nullalways presentThe total number of text tokens in this Engram's current Claims, excluding its summary. It describes content size, not tokens billed for a request or the size of your eventual model prompt. Null when unavailable.
Minimum: 0
bornAtstring | nullalways presentWhen this Engram ID was first published, as an ISO-8601 timestamp. It is not the date of the oldest source Claim. Null when the publication time is unknown for older memory.
updatedAtstring | nullalways presentWhen the Engram's Claim membership or summary text last changed, as an ISO-8601 timestamp. A summary written after consolidation can advance it. Reads and changes only to scores, status or labels do not. It is not a version for the entire object. Null when the content-change time is unknown.
claimsobjectconditionalA page of Claims currently in this Engram. Read claims.data for the statements and follow claims.nextPageUrl for more. Workspace detail and completed-memory results load an initial page by default; list requests need include=claims. An omitted field means Claims were not loaded, not that the Engram is empty.
Show nested fields
dataarrayalways presentClaims loaded on this page. A short or empty page can still have a continuation.
Show item fields
idstringalways presentThe ID Augenta assigns to this statement, starting with clm_. Use it to match a Claim in extractedClaims.data with the same Claim in an Engram's claims.data. It belongs to the Workspace or one-shot result that returned it.
textstringalways presentThe statement extracted from your source, such as Production releases require owner approval. Read this field for the Claim's content. Claims do not have labels.
experiencestring | nullalways presentThe id of the Experience this Claim came from. In Workspace mode, use it with GET /v1/experiences/{id} to check processing status. Null means the source could not be identified for an older Claim.
atstringalways presentWhen this statement was observed in its source, as an ISO-8601 timestamp. This is not the time you fetched the Claim.
sourceobjectconditionalAdditional source details, such as a conversation session or document path, when available. The fields depend on how the source was submitted. Omitted when no source details are available.
nextPageUrlstring | nullalways presentFollow this relative URL unchanged. Null means there is no next page. One-shot output can still omit items when truncated is true.
urlstringconditionalThe collection's resource path, when available. Use nextPageUrl, rather than this path, to load the next page.
truncatedbooleanconditionalTrue when a bounded one-shot result omitted items. One-shot results have no browsing continuation; use Workspace-backed memory when you need subsequent retrieval. False means all selected items were returned. Workspace lists use nextPageUrl instead.
billingobjectconditionalPresent when billing is enabled. USD amount is exact. Receipt references settle only on successful server delivery; retries reuse the original debit.
Show nested fields
operationIdstringalways presentpriceVersionstringalways presentsourceTokensintegeralways presentMinimum: 0
memoryTokensintegeralways presentMinimum: 0
measuredMemoryTokensintegeralways presentMinimum: 0
replayedbooleanalways presentcomplimentarybooleanconditionalratedAmountstringconditionalamountstringalways presentreceiptIdsarrayalways presentShow item fields
See the complete schema in the OpenAPI specification.
nextPageUrlstring | nullalways present