API Reference

This is the complete API reference for Memokit. All endpoints are RESTful and return JSON responses.

Base URL

https://api.memokit.dev

All requests require an API key in the Authorization header:

Authorization: Bearer mk_your_api_key

See Authentication for details.

The current API version is v1. All endpoints are prefixed with /v1/.

Method	Endpoint	Description
`POST`	`/v1/memories`	Create a new memory
`POST`	`/v1/memories/search`	Search memories semantically
`GET`	`/v1/memories`	List memories
`GET`	`/v1/memories/:id`	Get a specific memory
`DELETE`	`/v1/memories/:id`	Delete a memory

Code	Description
`200`	Success
`201`	Created
`400`	Bad Request - Invalid parameters
`401`	Unauthorized - Invalid or missing API key
`403`	Forbidden - Quota exceeded
`404`	Not Found
`429`	Too Many Requests - Rate limited
`500`	Internal Server Error

All errors follow this format:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message"
  }
}

List endpoints support pagination with these parameters:

Parameter	Type	Default	Description
`page`	number	1	Page number
`limit`	number	20	Items per page (max 100)

Response includes pagination info:

{
  "items": [...],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "totalPages": 8
  }
}

See Rate Limits for details on API rate limiting.