Skip to content
AugentaDocsOpen console ↗
Get an experience

Documentation

API reference
View Markdown

Get an experience

GET/v1/experiences/{id}

Where one experience stands: accepted → processed → consolidated, or failed.

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

idstringrequired

path parameter.

Responses

The experience's status.

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