# The Experience object

> A stored source's identity and processing status.

Submit source envelopes with [Experiences](https://augenta.pages.dev/docs/experiences.md), or use [Consolidate](https://augenta.pages.dev/docs/consolidate.md)
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

* [POST `/v1/experiences` — Create experiences](https://augenta.pages.dev/docs/api-reference/create-experiences.md)
* [GET `/v1/experiences/{id}` — Get an experience](https://augenta.pages.dev/docs/api-reference/get-experience.md)

## Attributes

These are response fields: always present can allow null; conditional fields can be omitted.

<a id="experience-object"></a>

### `experience.object`

`string` · always present

Allowed values: `"experience"`.

<a id="experience-id"></a>

### `experience.id`

`string` · always 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.

<a id="experience-status"></a>

### `experience.status`

`string` · always 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 values: `"accepted"`, `"processed"`, `"consolidated"`, `"failed"`.

<a id="experience-billingoperationid"></a>

### `experience.billingOperationId`

`string` · conditional

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

<a id="experience-claimids"></a>

### `experience.claimIds`

`array<string>` · conditional

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

<a id="experience-billing"></a>

### `experience.billing`

`object` · conditional

Present when billing is enabled. USD amount is exact. Receipt references settle only on successful server delivery; retries reuse the original debit.

<a id="experience-billing-operationid"></a>

### `experience.billing.operationId`

`string` · always present

<a id="experience-billing-priceversion"></a>

### `experience.billing.priceVersion`

`string` · always present

<a id="experience-billing-sourcetokens"></a>

### `experience.billing.sourceTokens`

`integer` · always present

Minimum: `0`.

<a id="experience-billing-memorytokens"></a>

### `experience.billing.memoryTokens`

`integer` · always present

Minimum: `0`.

<a id="experience-billing-measuredmemorytokens"></a>

### `experience.billing.measuredMemoryTokens`

`integer` · always present

Minimum: `0`.

<a id="experience-billing-replayed"></a>

### `experience.billing.replayed`

`boolean` · always present

<a id="experience-billing-complimentary"></a>

### `experience.billing.complimentary`

`boolean` · conditional

<a id="experience-billing-ratedamount"></a>

### `experience.billing.ratedAmount`

`string` · conditional

<a id="experience-billing-amount"></a>

### `experience.billing.amount`

`string` · always present

<a id="experience-billing-receiptids"></a>

### `experience.billing.receiptIds`

`array<string>` · always present

<a id="experience-type"></a>

### `experience.type`

`string` · always present

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

<a id="experience-workspace"></a>

### `experience.workspace`

`string` · always present

The ID of the Workspace storing this Experience.

<a id="experience-acceptedat"></a>

### `experience.acceptedAt`

`string` · always present

When Augenta accepted and stored this source.

<a id="experience-processedat"></a>

### `experience.processedAt`

`string` · conditional

When processing completed, if it has finished.

<a id="experience-consolidatedat"></a>

### `experience.consolidatedAt`

`string` · conditional

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

<a id="experience-experienceid"></a>

### `experience.experienceId`

`string` · conditional

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

<a id="experience-claimcount"></a>

### `experience.claimCount`

`integer` · conditional

How many claims were extracted, once processed.

<a id="experience-error"></a>

### `experience.error`

`object` · conditional

Why it failed. Present only when `status` is `failed`.

<a id="experience-error-code"></a>

### `experience.error.code`

`string` · always present

<a id="experience-error-message"></a>

### `experience.error.message`

`string` · always present

## Example object

```json
{
  "object": "experience",
  "id": "exp_000000000000000000000001",
  "type": "doc",
  "workspace": "ws-product",
  "status": "processed",
  "acceptedAt": "2026-10-28T12:00:00.000Z",
  "processedAt": "2026-10-28T12:00:01.000Z",
  "claimCount": 1
}
```
