Create a memory

post

Create a new memory record.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Bearer {apikey}

Path parameters

agentIdstringRequired

The ID of the agent.

customerIdstringRequired

The ID of the customer.

Body

application/json

typestring · enumRequired

Specifies the type of memory object.

Possible values:

contentstringRequired

The main content or description of the memory.

importanceinteger · min: 1 · max: 10Optional

A numerical value indicating the level of importance of the memory. Importance can range from 1 to 10, with a default of 1.

Default: 1

segmentstringOptional

The segment of the memory.

Example: memories.customer.customer123

Responses

200

Successful Response

application/json

400

Bad Request

application/json

403

Forbidden

application/json

404

Not Found

application/json

post

/v1/agents/{agentId}/customers/{customerId}/memories

HTTPcURLJavaScriptPython

POST /v1/agents/{agentId}/customers/{customerId}/memories HTTP/1.1
Host: api.voxity.ai
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 96

{
  "type": "observation",
  "content": "text",
  "importance": 1,
  "segment": "memories.customer.customer123"
}

{
  "id": "text",
  "type": "observation",
  "segment": "text",
  "content": "text",
  "importance": 1,
  "timeMark": 1,
  "createdAt": "2025-12-13T02:43:38.445Z",
  "updatedAt": "2025-12-13T02:43:38.445Z"
}