Get trace world state

Returns a trace's current world state: its tasks (every status; a subtask names its parent) and its facts, from the task engine for a trace it owns and otherwise from the task tracker, whose task records state facts only where the workspace's records take them, plus the end user's durable cross-trace profile. There is no history of state changes. A trace with no tasks or facts returns 200 with hasData false and empty segments.

get/api/v1/data/conversations/{conversationId}/world-state

Request

Base URL
https://moda.dev
Auth
API key in header x-api-key

Path parameters

conversationIdstring required

Trace ID (the conversation_id field).

Query parameters

tenant_idstring

Accepted by the shared handler for dashboard JWT requests; API-key requests remain scoped to the tenant on the key.

summary_only'1'

When set to 1, return segment summaries (fact counts and top keys per segment) instead of the segments.

event_limitinteger

Retired with the world-state event log: accepted and ignored.

Response

Successful response.

object required

Trace world state: hasData, userId, userDurableProfile, conversationWarmstart, segments (or segmentSummaries), source ("task_engine" for a trace the engine owns), and summary (segmentCount, lastUpdatedAt).

Changes

No recorded changes to this operation across all 1 revision of this API.