Skip to content
AugentaDocsOpen console ↗
The Experience object

Documentation

API reference
View Markdown

The Experience object

A stored source's identity and processing status.

Submit source envelopes with Experiences, or use Consolidate to submit and wait until their claims are extracted. Workspace ingestion returns compact Experience references. The status resource below adds source type, Workspace and processing timestamps.

Workspace acceptance does not imply immediate consolidation. One-shot Consolidate returns references to its input sources; these have no stored Experience status URLs. Source envelopes are request data with their own fields, separate from this response object.

Available operations

Usage and lifecycle →

The Experience object

Attributes

These are response fields. “Always present” can still allow null; “conditional” means the field can be omitted.

objectstringalways present

Allowed: "experience"

idstringalways present

The ID Augenta assigns to this submitted source. In Workspace mode, use it with GET /v1/experiences/{id} to check processing status. One-shot source references have no stored status URL.

statusstringalways present

accepted: the source is stored and waiting for processing. processed: its Claims have been extracted and stored; Recall can search them even before they form an Engram. consolidated: a Workspace consolidation has covered those Claims. failed: processing could not complete; read error. Acceptance or a bounded wait does not promise immediate consolidation.

Allowed: "accepted""processed""consolidated""failed"

billingOperationIdstringconditional

Reference to this source's billing operation, when billing is enabled.

claimIdsarrayconditional

IDs of Claims extracted from this source, when returned. Read extractedClaims.data or an Engram's claims.data for their text.

Show item fields
billingobjectconditional

Present 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 present
priceVersionstringalways present
sourceTokensintegeralways present

Minimum: 0

memoryTokensintegeralways present

Minimum: 0

measuredMemoryTokensintegeralways present

Minimum: 0

replayedbooleanalways present
complimentarybooleanconditional
ratedAmountstringconditional
amountstringalways present
receiptIdsarrayalways present
Show item fields
typestringalways present

The kind of source submitted: for example, trajectory for a conversation or agent run, or doc for a document.

workspacestringalways present

The ID of the Workspace storing this Experience.

acceptedAtstringalways present

When Augenta accepted and stored this source.

processedAtstringconditional

When processing completed, if it has finished.

consolidatedAtstringconditional

When consolidation covered this Experience, if it has been consolidated.

experienceIdstringconditional

An additional processing reference, when available. Use id, the exp_ identifier, in public resource URLs.

claimCountintegerconditional

How many claims were extracted, once processed.

errorobjectconditional

Why it failed. Present only when status is failed.

Show nested fields
codestringalways present
messagestringalways present