docs

HTTP API

Use the HTTP API for custom importers, dashboards, or tools that do not speak MCP.

https://conare.ai

Authenticate with a Conare API key:

Authorization: Bearer cmem_your_key_here

Add one memory

curl https://conare.ai/api/memories \
  -H "Authorization: Bearer cmem_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "We decided to keep docs inside the main Nuxt app.",
    "containerTag": "saved",
    "metadata": { "project": "conare" }
  }'

Request body:

Field	Required	Notes
`content`	Yes	Text to store.
`containerTag`	No	Defaults to `default`.
`metadata`	No	JSON object for source IDs, project names, hashes, or timestamps.

Search memories

curl https://conare.ai/api/search \
  -H "Authorization: Bearer cmem_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Nuxt Content docs integration decision",
    "containerTag": "codex-chats",
    "project": "conare",
    "limit": 10
  }'

The HTTP search API returns ranked memory results. MCP search adds LLM synthesis by default.

Useful fields:

Field	Notes
`query`	Required search phrase.
`containerTag`	Exact container filter.
`project`	Fuzzy project filter.
`limit`	Final result count.
`after` / `before`	Unix timestamps in milliseconds.
`hybrid`	Set `false` to disable hybrid vector plus FTS search.
`rerank`	Set `false` to skip reranking.

List memories

curl "https://conare.ai/api/memories?containerTag=saved&limit=20&offset=0" \
  -H "Authorization: Bearer cmem_your_key_here"

Read, update, delete

curl https://conare.ai/api/memories/MEMORY_ID \
  -H "Authorization: Bearer cmem_your_key_here"

curl -X PUT https://conare.ai/api/memories/MEMORY_ID \
  -H "Authorization: Bearer cmem_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "content": "Updated memory text" }'

curl -X DELETE https://conare.ai/api/memories/MEMORY_ID \
  -H "Authorization: Bearer cmem_your_key_here"

Bulk import

curl https://conare.ai/api/memories/bulk \
  -H "Authorization: Bearer cmem_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "content": "Imported note",
        "containerTag": "saved",
        "metadata": { "dedupKey": "note-1" }
      }
    ]
  }'

Bulk import accepts up to 50 items and 500,000 characters per request.

MCP endpoint

Agents should usually use MCP instead of raw HTTP:

https://conare.ai/mcp