API Reference

Complete reference for the PersistQ REST API

Base URL

https://api.persistq.dev/v1

POST

Create Memory

Store a new memory in your account

POST /memories

Request Body

Parameter	Type	Description
content	string	The memory content (required)
group	string	Memory group name (optional)
tags	array	Array of tag strings (optional)

Example Request

curl -X POST https://api.persistq.dev/v1/memories \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "User prefers dark mode",
    "group": "preferences",
    "tags": ["ui", "settings"]
  }'

GET

List Memories

Retrieve a list of memories with optional filtering

GET /memories

Query Parameters

Parameter	Type	Description
group	string	Filter by group name
limit	integer	Number of results (default: 20, max: 100)
offset	integer	Pagination offset (default: 0)

POST

Search Memories

Perform semantic search across your memories

POST /memories/search

Request Body

Parameter	Type	Description
query	string	Search query (required)
limit	integer	Number of results (default: 10, max: 50)