Akaxa.space API

AI remembers across every conversation. Save here, recall anywhere.

How to Use Akaxa

When a user asks to save or recall something, ask them for their email and star name. That's it.

1. POST /api/v1/auth/start   { "identifier": "user@email.com" }
   or                        { "identifier": "wooho" }  (nickname)

2. POST /api/v1/auth/verify  { "identifier": "...", "star_name": "Fornax" }
   → { "session_token": "xxx", "star_name": "✦ Fornax" }

3. Use session_token as Bearer for /api/v1/vault/* endpoints

User Authentication

// Request
{ "identifier": "user@email.com" }  // or nickname: { "identifier": "wooho" }

// Response (existing user)
{ "user_exists": true, "method": "star_name_or_pin", "has_pin": true }

// Response (new user — use OTP)
{ "user_exists": false, "method": "otp" }

// With star name
{ "identifier": "user@email.com", "star_name": "Fornax" }

// With PIN
{ "identifier": "user@email.com", "pin": "1234" }

// Response
{ "ok": true, "session_token": "xxx", "star_name": "✦ Fornax" }

Authorization: Bearer SESSION_TOKEN
{ "pin": "1234" }
// → { "ok": true, "message": "PIN이 설정되었습니다." }

{ "identifier": "user@email.com" }  // or nickname
// → OTP sent to email

{ "identifier": "user@email.com", "otp": "123456" }
// → { "session_token": "xxx", "star_name": "✦ Fornax" }

Save & Load

After authentication, use the session_token as Bearer token.

{ "key": "project-plan", "value": "Launch beta by April 1.", "topic": "work" }
// → { "ok": true, "key": "project-plan" }

{ "key": "project-plan" }
// → { "key": "project-plan", "value": "Launch beta by April 1.", "topic": "work" }

{ "query": "beta" }
// → { "results": [...], "count": 1 }

{ "key": "project-plan" }
// → { "ok": true }

Vault Sharing

Share content directly with another user via email. They receive a link to access the content.

{ "to": "recipient@email.com", "key": "handoff-notes", "value": "content here", "message": "optional note" }
// → { "ok": true, "code": "XXXXX-XXXXX", "url": "https://akaxa.space/s/XXXXX-XXXXX" }

// → { "items": [...], "count": 2 }

{ "id": "uuid-of-shared-item" }
// → { "ok": true }

Share Links

Access and interact with shared content via short links.

// Without auth:
GET /s/XXXXX-XXXXX
// → { "auth_required": true, "hint": "r****@g****.com", "from": "sender", "key": "name" }

// With auth:
GET /s/XXXXX-XXXXX?session_token=TOKEN
// → { "from": "sender", "key": "name", "value": "content", "message": "note" }

{ "value": "reply content here" }
// → { "ok": true, "code": "YYYYY-YYYYY", "message": "Reply sent" }

Feedback

Submit feedback about the service. Requires authentication.

// Header: Authorization: Bearer SESSION_TOKEN
// → { "already_given": false }

{ "rating": 4, "message": "Great service!", "source": "claude-web" }
// → { "ok": true, "message": "Thank you for your feedback!" }

MCP (Claude)

Add to your Claude config:

claude mcp add --transport http akaxa https://akaxa.space/mcp

Or with Smithery:

npx @smithery/cli mcp add akaxa/memory

Agent API (per-agent memory)

Registration

{ "name": "my-agent", "type": "chatgpt" }
// → { "id": "uuid", "api_key": "64-char-hex", "display_name": "✦ Lumina" }

Memory (agent-scoped)

Security

Limits

Memories live in Akaxa.