Create one or more memory entries for a profile. Each entry receives a system-generated memory ID.
URI: /api/v1/agentic/memory
Format: application/json
HTTP Method: POST
Authentication: Bearer JWT
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| profile_id | String | Yes | Profile ID of the Individual or User. |
| profile_type | String | Yes | Type of profile. Values: individual, employee. |
| category | String | Yes | Partition key for the memory entries, such as PROFILE_FACT. |
Request Headers
| Header | Required | Description |
|---|---|---|
| Authorization | Yes | Bearer JWT token. |
| Content-Type | Yes | application/json. |
Request Body Schema
| Field | Type | Required | Description |
|---|---|---|---|
| memories | Array | Yes | Memory entries to create. Minimum one entry. |
| memories[].content | String | Yes | Memory content. |
Example Request
{
"memories": [{ "content": "Prefers EST scheduling" }, { "content": "Allergic to peanuts" }]
}
Response Body Schema
| Field | Type | Description |
|---|---|---|
| statusCode | String | Operation status. Value: created. |
| memories | Array | The created memory entries. |
| memories[].memoryId | String | System-generated identifier for the memory entry. |
| memories[].content | String | Memory content. |
Example Response
Status: 200 OK
{
"statusCode": "created",
"memories": [
{ "memoryId": "mem_abc123", "content": "Prefers EST scheduling" },
{ "memoryId": "mem_def456", "content": "Allergic to peanuts" }
]
}
Error Codes
| Status Code | Description |
|---|---|
| 400 | Bad Request. Invalid request format or missing required fields. |
| 401 | Unauthorized. Invalid or missing JWT token. |
| 500 | Internal Server Error. |