Trigger manual consolidation

POST

/api/v1/ai/memory/consolidate

const url = 'https://api.ultimateteam.ai/api/v1/ai/memory/consolidate';
const options = {method: 'POST', headers: {'X-API-Key': '<X-API-Key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.ultimateteam.ai/api/v1/ai/memory/consolidate \
  --header 'X-API-Key: <X-API-Key>'

Trigger manual memory crystal consolidation.

Runs near-duplicate consolidation followed by inactivity pruning (mirrors the weekly cadence worker) for the caller’s tenant only.

Args: user: Authenticated user context. session: Request-scoped DB session (committed on success).

Returns: Consolidation result with real merge/prune counts.

Authorizations

ApiKeyAuth

Responses

200

Successful Response

application/json

MemoryConsolidationResult

Result of a memory consolidation run.

object

crystals_archived

required

Crystals Archived

integer

crystals_merged

required

Crystals Merged

integer

crystals_pruned

required

Crystals Pruned

integer

duration_ms

required

Duration Ms

integer

merge_errors

Merge Errors

integer

Example

{
  "merge_errors": 0
}