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

Parameter	Required	Description
conversationId	Yes	Conversation identifier.

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

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.

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

Status: 202 Accepted

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.