Skip to main content
GET
/
v1
/
memories
/
facets
List filterable fields
curl --request GET \
  --url https://api.production.xtrace.ai/v1/memories/facets \
  --header 'X-Org-Id: <api-key>' \
  --header 'x-api-key: <api-key>'
{
  "object": "facets",
  "fields": [
    {
      "name": "<string>",
      "type": "<string>",
      "indexed": true,
      "core": true,
      "org_default": "<string>",
      "values": [
        "<string>"
      ]
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.mem.xtrace.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Long-lived org API key. Alternative: Authorization: Bearer <key>.

​
X-Org-Id
string
header
required

Required alongside the API key (no key→org reverse index).

Headers

​
X-Service-Token
string | null

Response

Successful Response

Response shape for GET /v1/memories/facets.

core fields are the always-available axes (entity ids, type, created_at). PR 4 dropped the server-side auto-default for app_id (zero-entity ingests now require conv_id); the field stays on :class:FacetField for callers that promote per-org metadata facets but is always None for core rows.

​
object
string
default:facets
Allowed value: "facets"
​
fields
FacetField · object[]