{"openapi":"3.0.3","info":{"title":"AgentMind API","description":"Persistent memory and real-time live data for AI agents. Store context across sessions, recall it instantly, and fetch fresh news, weather, and search results on demand — without burning context window tokens.","version":"1.0.0","contact":{"url":"https://www.agentmind.agency/docs"}},"servers":[{"url":"https://www.agentmind.agency","description":"Production"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"},"BearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"}}}}},"paths":{"/api/ac/ping":{"get":{"operationId":"ping","summary":"Health check + pricing info. No auth required.","tags":["Utility"],"security":[],"responses":{"200":{"description":"Service status and pricing"}}}},"/api/ac/register":{"post":{"operationId":"registerAgent","summary":"Self-register to get a free API key with $0.50 starter credits. No auth required.","tags":["Utility"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string","format":"email"},"name":{"type":"string"}}}}}},"responses":{"200":{"description":"API key issued","content":{"application/json":{"schema":{"type":"object","properties":{"agent_key":{"type":"string","example":"am_abc123..."},"credit_balance_cents":{"type":"integer","example":50},"plan":{"type":"string","example":"pay_as_you_go"}}}}}}}}},"/api/ac/memory":{"post":{"operationId":"storeMemory","summary":"Store or update a persistent memory ($0.01)","tags":["Memory"],"security":[{"ApiKeyHeader":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["agent_key","memory_key","memory_value"],"properties":{"agent_key":{"type":"string","description":"Must match your X-API-Key header"},"memory_key":{"type":"string","description":"Unique key for this memory"},"memory_value":{"type":"string","description":"Content to store"},"memory_type":{"type":"string","enum":["context","preference","workflow","fact"],"default":"context"},"metadata":{"type":"object"}}}}}},"responses":{"200":{"description":"Memory stored"},"401":{"description":"Invalid or missing API key"},"402":{"description":"Insufficient credits"}}},"get":{"operationId":"retrieveMemory","summary":"Retrieve a memory by key ($0.01)","tags":["Memory"],"security":[{"ApiKeyHeader":[]}],"parameters":[{"name":"agent_key","in":"query","required":true,"schema":{"type":"string"}},{"name":"memory_key","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Memory retrieved"},"404":{"description":"Memory not found"}}},"delete":{"operationId":"deleteMemory","summary":"Delete a memory (free)","tags":["Memory"],"security":[{"ApiKeyHeader":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["agent_key","memory_key"],"properties":{"agent_key":{"type":"string","description":"Must match your X-API-Key header"},"memory_key":{"type":"string"}}}}}},"responses":{"200":{"description":"Deleted"}}}},"/api/ac/memory/search":{"post":{"operationId":"searchMemories","summary":"List all memories for your agent, with optional type filter ($0.01)","tags":["Memory"],"security":[{"ApiKeyHeader":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["agent_key"],"properties":{"agent_key":{"type":"string","description":"Must match your X-API-Key header"},"memory_type":{"type":"string","enum":["context","preference","workflow","fact"]},"limit":{"type":"integer","default":50,"minimum":1,"maximum":100}}}}}},"responses":{"200":{"description":"List of memories"}}}},"/api/ac/data":{"post":{"operationId":"fetchLiveData","summary":"Fetch real-time data: news, search, weather, or prices ($0.02 fresh / free cached)","tags":["Live Data"],"security":[{"ApiKeyHeader":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["agent_key","query_type","query"],"properties":{"agent_key":{"type":"string","description":"Must match your X-API-Key header"},"query_type":{"type":"string","enum":["news","search","weather","price"],"description":"news=latest articles, search=web results, weather=current conditions, price=asset price"},"query":{"type":"string","description":"Search term, city name, or asset name"},"cache_minutes":{"type":"integer","default":15,"description":"Cache TTL in minutes. Cached hits are free."}}}}}},"responses":{"200":{"description":"Live data response","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object"},"from_cache":{"type":"boolean"},"cost_cents":{"type":"integer"}}}}}}}}}}}