Create Memories

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

1{
2  "memories": [{ "content": "Prefers EST scheduling" }, { "content": "Allergic to peanuts" }]
3}

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

1{
2  "statusCode": "created",
3  "memories": [
4    { "memoryId": "mem_abc123", "content": "Prefers EST scheduling" },
5    { "memoryId": "mem_def456", "content": "Allergic to peanuts" }
6  ]
7}

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.

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