Skip to main content
Nowledge MemNowledge Mem
API ReferenceThreadsThread_id

Get Thread

GET
/threads/{thread_id}

Get a thread with paged messages. Cloud additionally returns independently paged current readable Memory and Entity associations; associations do not establish distillation coverage or processing completion. Local servers retain their existing unpaged related-result projection.

Path Parameters

thread_id*Thread Id

Query Parameters

limit?|

Maximum transcript messages requested. Cloud accepts 0 for a metadata-only read, passes positive limits through, and treats an explicit negative limit (including -1) as a full-transcript read. Omitting the parameter uses the server default. Local servers retain their existing limit behavior. Related-result pagination is independent of the transcript window.

offset?Offset

Skip first N messages

Range0 <= value
Default0
space_id?|

Optional isolation space guard

thread_reference?string

Optional canonical Local stored-row URI returned as thread_reference. Selects that exact row within the existing Space lens. It never falls back to thread_id. Hosted Cloud rejects Local stored references.

identity_namespace?string

Local/self-hosted detail-only selector. public resolves the canonical public ID without a storage fallback; storage selects its immutable storage ID. Cannot be combined with thread_reference. An explicit space_id is matched exactly, including blank, whitespace, padded and literal all values.

Value in

  • "public"
  • "storage"
require_unique_identity?boolean

Request exact identity proof before a mutation. More than one readable public/storage match returns thread_read_identity_ambiguous. A successful proof response includes identity_is_unique=true; older servers without that proof must not authorize an inferred-Space write. Ordinary browsing is unchanged.

Defaultfalse
related_memories_cursor?string

Cloud Memory page position returned by related_results. Omit for the first page. Bound to the exact workspace, physical Thread and Space; each request rechecks current member and key reach. The position grants no access. Local servers retain their existing related-result behavior.

Lengthlength <= 2048
related_entities_cursor?string

Cloud Entity page position returned by related_results. Omit for the first page. Bound to the exact workspace, physical Thread and Space; each request rechecks current member and key reach. The position grants no access. Local servers retain their existing related-result behavior.

Lengthlength <= 2048

Response Body

application/json

application/json

curl -X GET "https://example.com/threads/string"
{  "covered_message_ids": [    "string"  ],  "entities": [    "string"  ],  "identity_is_unique": true,  "identity_namespace": "public",  "messages": [    {      "content": "string",      "created_at": "2019-08-24T14:15:22Z",      "id": "string",      "metadata": {},      "node_type": "Thread",      "order_index": 0,      "role": "string",      "timestamp": "2019-08-24T14:15:22Z",      "token_count": 0,      "updated_at": "2019-08-24T14:15:22Z"    }  ],  "related_memories": [    {      "access_count": 0,      "appearances": 0,      "clicks": 0,      "confidence": 0.5,      "content": "string",      "created_at": "2019-08-24T14:15:22Z",      "crystal_title": "string",      "decay_score_cached": 1,      "embedding": [        0      ],      "event_end": "string",      "event_start": "string",      "extraction_method": "manual",      "id": "string",      "importance": 0.5,      "is_crystal": false,      "is_latest": true,      "last_accessed_at": "2019-08-24T14:15:22Z",      "last_clicked_at": "2019-08-24T14:15:22Z",      "last_evaluated_at": "2019-08-24T14:15:22Z",      "last_reindexed_at": "2019-08-24T14:15:22Z",      "metadata": {},      "node_type": "Thread",      "pagerank_score": 0,      "reindex_needed": false,      "review_status": "",      "semantic_field": "string",      "source": "string",      "source_range": {        "property1": 0,        "property2": 0      },      "source_unit_count": 0,      "space_id": "default",      "temporal_confidence": 0,      "temporal_context": "timeless",      "temporal_precision": "string",      "temporal_type": "string",      "title": "string",      "total_dwell_time_ms": 0,      "unit_type": "fact",      "updated_at": "2019-08-24T14:15:22Z",      "version": 1    }  ],  "thread": {    "created_at": "2019-08-24T14:15:22Z",    "id": "string",    "import_date": "2019-08-24T14:15:22Z",    "message_count": 0,    "metadata": {},    "node_type": "Thread",    "participants": [      "string"    ],    "project": "string",    "source": "string",    "space_id": "default",    "storage_id": "string",    "summary": "string",    "thread_id": "string",    "thread_reference": "string",    "title": "string",    "tool_version": "string",    "updated_at": "2019-08-24T14:15:22Z",    "workspace": "string"  },  "total_messages": 0,  "total_tokens": 0,  "related_entity_items": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string",      "entity_type": "string",      "space_id": "string"    }  ],  "related_results": {    "memories": {      "availability": "available",      "has_more": true,      "next_cursor": "string"    },    "entities": {      "availability": "available",      "has_more": true,      "next_cursor": "string"    }  }}