Sync

Get Sync Tiers

Return initial Tier 0 (goals/OKRs/use-cases --> tier 0 memories) and Tier 1 (hot memories) for the requesting user/workspace.

This is a minimal initial implementation to enable SDK integration. It uses simple heuristics and will be enhanced with analytics-driven selection.

post/v1/sync/tiers

Request body

max_tier0integer

Max Tier 0 items (goals/OKRs/use-cases)

max_tier1integer

Max Tier 1 items (hot memories)

workspace_idstring nullable

Optional workspace id to scope tiers

user_idstring nullable

Optional internal user ID to filter tiers by a specific user. If not provided, results are not filtered by user. If both user_id and external_user_id are provided, user_id takes precedence.

external_user_idstring nullable

Optional external user ID to filter tiers by a specific external user. If both user_id and external_user_id are provided, user_id takes precedence.

organization_idstring nullable

Optional organization ID for multi-tenant scoping. When provided, tiers are scoped to memories within this organization.

namespace_idstring nullable

Optional namespace ID for multi-tenant scoping. When provided, tiers are scoped to memories within this namespace.

include_embeddingsboolean

Include embeddings in the response. Format controlled by embedding_format parameter.

embedding_format'int8' | 'float32'

Embedding format options for sync tiers

embed_modelstring

Embedding model hint: 'sbert' or 'bigbird' or 'Qwen4B'

embed_limitinteger

Max items to embed per tier to control latency

Example request

{
  "embed_limit": 200,
  "embed_model": "sbert",
  "external_user_id": "external_user_abc",
  "include_embeddings": false,
  "max_tier0": 300,
  "max_tier1": 1000,
  "user_id": "internal_user_123",
  "workspace_id": "workspace_123"
}

Response

Tier assignments returned

codeinteger

HTTP status code

statusstring

'success' or 'error'

transitionsobject[]

Transition items between tiers

next_cursorstring nullable

Cursor for pagination

has_moreboolean

Whether there are more items available

errorstring nullable

Error message if failed

{"stackTrail":"components:schemas:SyncTiersResponse:properties:details:anyOf","oasType":"schema","type":"unknown","title":"Details","description":"Additional error details or context","nullable":true}

Example response

{
  "code": 200,
  "has_more": false,
  "status": "success",
  "tier0": [
    {
      "content": "Improve API performance",
      "id": "goal_123",
      "metadata": {
        "class": "goal",
        "sourceType": "papr"
      },
      "topics": [
        "performance",
        "api"
      ],
      "type": "goal"
    }
  ],
  "tier1": [
    {
      "content": "Customer complained about slow API response times",
      "id": "memory_456",
      "metadata": {
        "sourceType": "papr"
      },
      "topics": [
        "customer",
        "api",
        "performance"
      ],
      "type": "text"
    }
  ],
  "transitions": []
}

Changes

Changed in 8 of the 37 revisions of this API.223

May 31, 20263f6cc27b443e2See the full diff
- ○
  added the optional property tier0/items/holographic_frequency_scores to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property tier1/items/holographic_frequency_scores to the response with the 200 status
  response-optional-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Mar 13, 20260e4854909d2a2See the full diff
- ○
  added the optional property detail/items/ctx to the response with the 422 status
  response-optional-property-added
- ○
  added the optional property detail/items/input to the response with the 422 status
  response-optional-property-added
Feb 7, 20265f5df128dbcd16See the full diff
- ○
  added the optional property tier0/items/metrics to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property tier0/items/popularity_score to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property tier0/items/recency_score to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property tier0/items/reranker_confidence to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property tier0/items/reranker_score to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property tier0/items/reranker_type to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property tier0/items/similarity_score to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property tier0/items/totalProcessingCost to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property tier1/items/metrics to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property tier1/items/popularity_score to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property tier1/items/recency_score to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property tier1/items/reranker_confidence to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property tier1/items/reranker_score to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property tier1/items/reranker_type to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property tier1/items/similarity_score to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property tier1/items/totalProcessingCost to the response with the 200 status
  response-optional-property-added
Dec 7, 202510ed8cdc1aa81See the full diff
- ○
  endpoint added
  endpoint-added
Nov 19, 2025d858eda77e5b1See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
Nov 19, 20252422ab514a9d1See the full diff
- ○
  endpoint added
  endpoint-added
Nov 7, 202534b5e739fd201See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Nov 7, 202514ff137558711See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 12 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history