---
schema_version: "1"
id: 1e62e8b6fbca647ee1c076705e96af9f4d82a5a7874cd8b368d4bf794c53dfb0
title: Add Entries
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/data-cloud/agentic-memory-context/references/agentic-memory-context-ref/agentic-memory-api-add-entries.md
canonical_url: https://developer.salesforce.com/docs/data/agentic-memory-context/references/agentic-memory-context-api-ref/agentic-memory-api-add-entries.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 94e1fbd47161ef90596c4b9e0089b399344178f66fdf1b7ed6b08f03f31b7a3d
products:
  - Agentic Memory & Context
  - Data 360 Developer Documentation
---
# 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            | 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

```json
{
  "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`

```json
{
  "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.                                          |