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 | No | Entry identifier. Server-generated if omitted. |
| 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
{
"sessionId": "sess-9001",
"entries": [
{
"id": "msg-id-001",
"participantId": "003AB000000XYZ",
"category": "Message",
"type": "user_message",
"content": "How do I reset my password?"
},
{
"id": "msg-id-002",
"participantId": "agent-bot-1",
"category": "Trace",
"type": "tool_call",
"variable": { "tool": "kb_search", "query": "password reset" }
},
{
"id": "msg-id-003",
"participantId": "agent-bot-1",
"category": "Message",
"type": "agent_response",
"content": "Here is the reset flow..."
}
]
}
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
{
"statusCode": "entriesAdded",
"conversationId": "...",
"sessionId": "..."
}
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. |