Add Entries

Send ordered sequences of interaction records to Data 360 as the conversation progresses. Entries can be messages (human-readable content) or traces (agent reasoning, tool calls, tool results).

URI: /api/v1/agentic/conversations/{conversationId}/entries

Format: application/json

HTTP Method: POST

Authentication: Bearer JWT

Path Parameters

Parameter	Required	Description
conversationId	Yes	Conversation identifier.

Request Headers

Header	Required	Description
Authorization	Yes	Bearer JWT token.
agent_id	Yes	Registered agent API name.

Request Body Schema

Field	Type	Required	Description
sessionId	String	Yes	Target session identifier.
entries	Array	Yes	Ordered entries. Minimum 1 required.
entries[].id	String	Yes	Entry identifier.
entries[].interactionId	String	No	Groups related entries (for example, a tool call and its result).
entries[].participantId	String	Yes	Author of the entry.
entries[].content	String	Conditional	Required for Message category. Not used for Trace category.
entries[].type	String	No	Entry type. Values: `user_message`, `agent_response`, `agent_reasoning`, `tool_call`, `tool_result`.
entries[].role	String	No	Role of the participant.
entries[].timestamp	String (ISO 8601)	No	Entry timestamp. Server stamps if omitted.
entries[].category	String	No	Entry category. Values: `Message`, `Trace`, `Entry`.
entries[].attachments	Array	No	Attachments with `contentType` and `contentUrl` fields.
entries[].variable	Map	No	Free-form payload. Used by Trace category for tool call data.

Example Request

1{
2  "sessionId": "sess-9001",
3  "entries": [
4    {
5      "participantId": "003AB000000XYZ",
6      "category": "Message",
7      "type": "user_message",
8      "content": "How do I reset my password?"
9    },
10    {
11      "participantId": "agent-bot-1",
12      "category": "Trace",
13      "type": "tool_call",
14      "variable": { "tool": "kb_search", "query": "password reset" }
15    },
16    {
17      "participantId": "agent-bot-1",
18      "category": "Message",
19      "type": "agent_response",
20      "content": "Here is the reset flow..."
21    }
22  ]
23}

Response Body Schema

Field	Type	Description
statusCode	String	Operation status. Value: `entriesAdded`.
conversationId	String	Parent conversation identifier.
sessionId	String	Parent session identifier.

Example Response

Status: 202 Accepted

1{
2  "statusCode": "entriesAdded",
3  "conversationId": "...",
4  "sessionId": "..."
5}

Error Codes

Status Code	Description
400	Bad Request. Invalid request format or missing required fields.
401	Unauthorized. Invalid or missing JWT token.
404	Not Found. Conversation does not exist.
500	Internal Server Error.

DID THIS ARTICLE SOLVE YOUR ISSUE?
Let us know so we can improve!