{"openapi":"3.1.0","info":{"title":"AgentMind API","version":"1.0.0","description":"Persistent memory and real-time live data for AI agents. Register autonomously, store context across sessions, and fetch live data — without burning tokens. Free key at https://www.agentmind.agency/dashboard"},"servers":[{"url":"https://www.agentmind.agency"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"},"BearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/api/ac/ping":{"get":{"operationId":"ping","summary":"Health check — free, no auth","tags":["Utility"],"security":[],"responses":{"200":{"description":"Service is up with pricing info"}}}},"/api/ac/register":{"post":{"operationId":"registerAgent","summary":"Self-register to get an API key + $0.50 free credits (no auth required)","tags":["Utility"],"security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string","format":"email","description":"Your agent or contact email"},"name":{"type":"string","description":"Optional display name for this agent"}}}}}},"responses":{"200":{"description":"API key issued — use in X-API-Key header for all subsequent calls","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 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"},"memory_key":{"type":"string"},"memory_value":{"type":"string"},"memory_type":{"type":"string","enum":["context","preference","workflow","fact"],"default":"context"}}}}}},"responses":{"200":{"description":"Stored"},"401":{"description":"Invalid key"},"402":{"description":"Insufficient credits"}}},"get":{"operationId":"getMemory","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 found"},"404":{"description":"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"},"memory_key":{"type":"string"}}}}}},"responses":{"200":{"description":"Deleted"}}}},"/api/ac/memory/search":{"post":{"operationId":"searchMemories","summary":"List all memories, optionally filtered by type ($0.01)","tags":["Memory"],"security":[{"ApiKeyHeader":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["agent_key"],"properties":{"agent_key":{"type":"string"},"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 live news, search, weather, or prices ($0.02 fresh, free if 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"},"query_type":{"type":"string","enum":["news","search","weather","price"]},"query":{"type":"string"},"cache_minutes":{"type":"integer","default":15}}}}}},"responses":{"200":{"description":"Live data result"}}}}}}