API Reference

Base URL

https://api.memcontext.in

All endpoints are prefixed with /api/.

Authentication

Every request must include an API key in the X-API-Key header:

curl https://api.memcontext.in/api/memories \
  -H "X-API-Key: mc_your_key"

API keys are created from the MemContext dashboard. See Authentication for details.

Endpoints

Method	Path	Description
`POST`	`/api/memories`	Save a memory
`GET`	`/api/memories`	List memories
`GET`	`/api/memories/search`	Search memories
`GET`	`/api/memories/profile`	Get user profile context
`GET`	`/api/memories/graph`	Memory graph data for visualization
`GET`	`/api/memories/{id}`	Get a memory by ID
`PATCH`	`/api/memories/{id}`	Update a memory
`DELETE`	`/api/memories/{id}`	Delete a memory
`POST`	`/api/memories/{id}/forget`	Forget a memory
`GET`	`/api/memories/{id}/history`	Get memory version history
`POST`	`/api/memories/{id}/feedback`	Submit feedback
`GET`	`/api/workspaces`	List workspaces available to the authenticated user
`POST`	`/api/workspaces`	Create a workspace
`GET`	`/api/workspaces/{id}/team`	List workspace members and pending invitations
`POST`	`/api/context-vault/documents`	Queue Context Vault text, URL, or remote file ingestion
`POST`	`/api/context-vault/documents/upload`	Upload and ingest a Context Vault file
`GET`	`/api/context-vault/documents`	List Context Vault documents
`GET`	`/api/context-vault/search`	Search Context Vault documents and extracted memories
`GET`	`/api/context-vault/memories`	Browse extracted and curated workspace memories

Response format

All successful responses return JSON. Error responses follow a consistent shape: For POST /api/memories, shorter memories usually return 201 with a final save result, while larger notes may return 202 Accepted with a jobId and message for tracking extraction into atomic memories.

{
  "error": "Human-readable error message",
  "code": "HTTP_404",
  "requestId": "abc123xyz456"
}

Every response includes an X-Request-Id header for tracing.

Rate limits

Rate-limited endpoints return the following headers:

Header	Description
`X-RateLimit-Limit`	Maximum requests in the current window.
`X-RateLimit-Remaining`	Requests remaining in the current window.
`X-RateLimit-Reset`	Unix timestamp when the window resets.

See Authentication for per-endpoint limits.

Request limits

Maximum request body size: 50 KB.
Memory content maximum length: 10,000 characters.
Search query maximum length: 1,000 characters.

Get Started

Concepts

Context Vault

Guides

SDK

MCP Tools

API Reference

Base URL

Authentication

Endpoints

Response format

Rate limits

Request limits

​Base URL

​Authentication

​Endpoints

​Response format

​Rate limits

​Request limits

Base URL

Authentication

Endpoints

Response format

Rate limits

Request limits