Search memories

post

Search memories.

Authorizations

ApiKeyAuth

AuthorizationstringRequired

Bearer {apikey}

Path parameters

agentIdstringRequired

The ID of the agent.

customerIdstringRequired

The ID of the customer.

Body

application/json

querystringRequired

The search term or phrase used to find relevant memory objects.

maxResultsinteger · max: 1000Optional

The maximum number of memory objects to return. MaxReturns can range from 0 to 1,000, with a default of 10.

Default: 10

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/search

HTTPcURLJavaScriptPython

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

{
  "query": "text",
  "filters": {
    "type": "observation",
    "segment": "text"
  },
  "maxResults": 10
}

{
  "data": [
    {
      "id": "text",
      "type": "observation",
      "segment": "text",
      "content": "text",
      "importance": 1,
      "timeMark": 1,
      "createdAt": "2025-12-13T02:58:52.973Z",
      "updatedAt": "2025-12-13T02:58:52.973Z"
    }
  ]
}