Conversations

Read conversation history from a workspace. Requires the conversations scope and a workspace_id.

GET/v1/conversationsconversations scope

List conversations in a workspace ordered by most recent activity.

Query parameters

Parameter	Type	Description
workspace_id *	string	Required. Workspace to list conversations from.
limit	integer	Max results to return. Default 20, max 100.
before	string	Cursor for pagination — return conversations before this conversation ID.

conversations = client.conversations.list(workspace_id="ws_abc123")
for conv in conversations:
    print(f"{conv.id}: {conv.title} ({conv.message_count} messages)")

GET/v1/conversations/:idconversations scope

Retrieve a specific conversation including its full message history.

Query parameters

Parameter	Type	Description
workspace_id *	string	Required. Must match the workspace the conversation belongs to.

conv = client.conversations.get(
    conversation_id="conv_xyz789",
    workspace_id="ws_abc123"
)
for msg in conv.messages:
    print(f"[{msg.role}]: {msg.content[:100]}")