Implementation: inc/Api/Chat/Chat.php

Data Machine stores chat conversations as user-scoped sessions in wp_datamachine_chat_sessions. Generic session CRUD is exposed through the canonical Agents API abilities backed by Data Machine’s active conversation store:

• agents/list-conversation-sessions
• agents/get-conversation-session
• agents/create-conversation-session
• agents/update-conversation-session-title
• agents/delete-conversation-session

Data Machine keeps product-owned session behavior such as read state, retention, reporting, and admin UX on Data Machine-specific APIs.

Authentication

Requires the Data Machine chat permission (PermissionHelper::can( 'chat' )).

Response Envelope

Session routes return:

{
  "success": true,
  "data": {}
}

The data shape is the corresponding canonical Agents API conversation-session ability result, except product-only routes such as read-state updates continue to use Data Machine-specific abilities.

Routes

GET /wp-json/datamachine/v1/chat/sessions

List sessions for the current user and scoped agent.

Delegates to agents/list-conversation-sessions.

Query parameters:

• limit (integer, optional, default 20): maximum sessions to return.
• offset (integer, optional, default 0): pagination offset.
• mode (string, optional): chat, pipeline, or system.
• agent_id (integer, optional): filter sessions by agent.

agent_type is not a REST parameter for this route.

GET /wp-json/datamachine/v1/chat/{session_id}

Retrieve one session by UUID-like session ID ([a-f0-9-]+).

Delegates to agents/get-conversation-session.

DELETE /wp-json/datamachine/v1/chat/{session_id}

Delete one session by UUID-like session ID.

Delegates to agents/delete-conversation-session.

POST /wp-json/datamachine/v1/chat/sessions/{session_id}/read

Mark a session read for the current user.

This is a Data Machine product-owned read-state operation and remains on datamachine/mark-session-read.

Errors

• session_not_found (404): session does not exist.
• session_access_denied (403): session belongs to another user.
• ability_not_found (500): session ability is not registered.