memories.status

await sdk.memories.status(ingestion_id)

Check the progress of an asynchronous ingestion job. Use the ingestion_id returned by memories.create, memories.batch_create, or memories.create_from_file.

Parameters

UUID

required

The ingestion job ID returned from a create call.

Returns

MemoryStatusResponse with the job’s current state and the IDs of any memories it has produced so far.

UUID

The ingestion job identifier.

string

The document identifier associated with this ingestion.

string

Current status of the ingestion job.

Value	Description
`queued`	Document is waiting to be processed
`processing`	Document is currently being processed through the pipeline
`completed`	All extraction and storage stages completed successfully
`failed`	Processing failed. Check `error_message` for details.
`partial_success`	Some extractions succeeded but others failed. Check `error_message` for details.

datetime

Timestamp when the job was queued.

datetime

Timestamp when processing started, or None if still queued.

datetime

Timestamp when processing finished, or None if still in progress.

integer

Number of memories produced from this ingestion so far.

List[UUID]

IDs of memories produced from this ingestion. You can pass these to memories.get.

string

Error description if status is failed or partial_success; otherwise None.

Example

from maximem_synap import MaximemSynapSDK

sdk = MaximemSynapSDK(api_key="synap_your_key_here")
await sdk.initialize()

status = await sdk.memories.status(result.ingestion_id)
print(status.status)            # e.g. "completed"
print(status.memories_created)  # e.g. 3
print(status.memory_ids)        # list of UUIDs

Raises

SynapAuthError: when the API key is missing or invalid.
SynapNotFoundError: when the ingestion_id is unknown.

Introduction

Lifecycle

Memory ingestion

Memory management

Conversation

Conversation context

Scoped context

User profile

Real-time streaming

Cache management

Credits & billing

Reference

Limits & Pricing

Parameters

Returns

Example

Raises

See also

​Parameters

​Returns

​Example

​Raises

​See also

Parameters

Returns

Example

Raises

See also