Skip to main content
GET
/
api
/
v1
/
memories
List User Memories
curl --request GET \
  --url https://draftliftai.com/api/v1/memories \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": 1,
      "title": "Brand Voice Guidelines",
      "body": "Our brand voice is professional yet approachable. We use active voice and avoid jargon.",
      "tags": [
        "brand",
        "voice",
        "style"
      ],
      "status": "active",
      "created_at": "2026-03-01T12:00:00Z",
      "updated_at": "2026-03-01T12:00:00Z"
    }
  ],
  "total": 123,
  "page": 123,
  "limit": 123,
  "total_pages": 123,
  "has_next": true,
  "has_prev": true
}

Authorizations

Authorization
string
header
required

API key (dl_live_...) or Supabase JWT token

Query Parameters

Search in title, body, and tags

tags
string

Comma-separated tags to filter by

category_id
integer

Filter by category ID

platform
string

Filter by platform (includes universal memories)

created_after
string<date-time>

Filter by creation date (after)

created_before
string<date-time>

Filter by creation date (before)

status_filter
string

Filter by status: draft, active, deleted, or all. Defaults to active/draft only.

page
integer
default:1

Page number (1-indexed)

Required range: x >= 1
limit
integer
default:10

Items per page (max 50)

Required range: 1 <= x <= 50
sort_by
string
default:created_at

Sort field: created_at, updated_at, title

sort_order
string
default:desc

Sort order: asc, desc

Response

Successful Response

Paginated response for memory listings.

items
MemoryResponse · object[]
required
total
integer
required
page
integer
required
limit
integer
required
total_pages
integer
required
has_next
boolean
required
has_prev
boolean
required