All API requests require a Bearer token:

Authorization: Bearer amk_your_api_key_here

Generate API keys from your dashboard.

https://api.agenticmemory.ai/v1

GET /v1/spaces

List all your memory spaces.

POST /v1/spaces

Create a new memory space.

{ "name": "my-agent", "slug": "my-agent" }

POST /v1/memory/{spaceId}/messages

Append a message to conversation history.

{ "role": "user", "content": "Hello!", "metadata": { "model": "llama3" } }

GET /v1/memory/{spaceId}/messages?limit=20

Retrieve recent messages in chronological order.

POST /v1/memory/{spaceId}/messages/batch

Append multiple messages at once.

{ "messages": [{ "role": "user", "content": "..." }, { "role": "assistant", "content": "..." }] }

PUT /v1/memory/{spaceId}/context/{key}

Set a context key-value pair.

{ "value": { "theme": "dark", "language": "en" } }

GET /v1/memory/{spaceId}/context/{key}

Get a single context value.

GET /v1/memory/{spaceId}/context

Get all context keys and values.

PUT /v1/memory/{spaceId}/scratchpad

Write working memory (any JSON).

{ "data": { "step": 3, "partial_result": "..." } }

GET /v1/memory/{spaceId}/scratchpad

Read working memory.