AgentMind
DashboardGet API Key

API Reference

Persistent memory + live data for AI agents. All endpoints live at /api/ac/...

Authentication

All paid endpoints require your API key via the X-API-Key header (or Authorization: Bearer). Get yours free from the dashboard or via the self-register endpoint.

# Header-based auth (recommended)
X-API-Key: am_your_key_here

# Bearer token style also accepted
Authorization: Bearer am_your_key_here

# Every request body must include agent_key matching your header key
{ "agent_key": "am_your_key_here", ... }

# OpenAPI spec for auto-binding tool-use
GET https://www.agentmind.agency/api/ac/openapi.json

# LLMs.txt guide for agent self-configuration
GET https://www.agentmind.agency/api/ac/llms.txt

Error Codes

400Bad request — missing or invalid fields
401Unauthorized — invalid, missing, or mismatched API key
402Payment required — insufficient credits
403Forbidden — agent_key in body does not match header key
404Not found — memory key does not exist
429Rate limited — slow down, check Retry-After header
500Server error — retry after a moment
GET/api/ac/pingCost: Free

Health Check

Check service status and see current pricing. No auth required.

Response

{
  "status": "ok",
  "service": "AgentMind",
  "version": "1.0.0"
}
POST/api/ac/registerCost: Free

Self-Register

Create a new API key autonomously. Returns 50 free credits ($0.50). No auth required — agents can call this themselves.

Request Body

emailstring (required) — your email address
namestring (optional) — agent display name

Response

{
  "success": true,
  "agent_key": "am_xxxxxxxxxxxxxxxxxxxx",
  "email": "agent@example.com",
  "credit_balance_cents": 50,
  "plan": "pay_as_you_go"
}
POST/api/ac/memoryCost: $0.01

Store Memory

Store or update a key-value memory. Overwrites if key already exists.

Request Body

agent_keystring (required) — must match your X-API-Key header
memory_keystring (required) — unique identifier for this memory
memory_valuestring (required) — content to store
memory_typestring (optional) — 'context' | 'preference' | 'workflow' | 'fact'
metadataobject (optional) — extra JSON to attach

Response

{
  "success": true,
  "memory_key": "user_prefs",
  "tokens_saved": 12
}
GET/api/ac/memoryCost: $0.01

Retrieve Memory

Get a single memory by key. Updates access timestamp and count.

Query Parameters

agent_keystring (required) — must match your X-API-Key header
memory_keystring (required)

Response

{
  "success": true,
  "memory": {
    "id": 1,
    "memory_key": "user_prefs",
    "memory_value": "dark mode",
    "access_count": 7
  }
}
DELETE/api/ac/memoryCost: Free

Delete Memory

Permanently delete a memory. Free of charge.

Request Body

agent_keystring (required) — must match your X-API-Key header
memory_keystring (required)

Response

{
  "success": true
}
POST/api/ac/memory/searchCost: $0.01

Search Memories

List all memories for your agent, optionally filtered by type.

Request Body

agent_keystring (required) — must match your X-API-Key header
memory_typestring (optional) — 'context' | 'preference' | 'workflow' | 'fact'
limitnumber (optional) — max 100, default 50

Response

{
  "success": true,
  "memories": [
    {
      "memory_key": "ctx_1",
      "memory_value": "...",
      "memory_type": "context"
    }
  ],
  "count": 1
}
POST/api/ac/dataCost: $0.02 live · Free cached

Fetch Live Data

Get real-time news, search results, weather, or prices. Results cached for 15 min — cached hits are free.

Request Body

agent_keystring (required) — must match your X-API-Key header
query_type'news' | 'search' | 'weather' | 'price'
querystring (required) — your search term or city name
cache_minutesnumber (optional) — cache TTL in minutes, default 15

Response

{
  "success": true,
  "data": {
    "query": "AI agents",
    "articles": [
      {
        "title": "...",
        "snippet": "...",
        "link": "..."
      }
    ]
  },
  "from_cache": false,
  "cost_cents": 2
}

Live Data Query Types

newsLatest news articles on any topice.g. “AI agents 2026”articles[] with title, snippet, link, source
searchGeneral web search resultse.g. “best LLM benchmarks”results[] with title, snippet, link
weatherCurrent weather for any citye.g. “Tokyo”temperature, condition, humidity, wind
priceWeb-sourced price info for any assete.g. “Bitcoin”summary snippet from top search result

Rate Limits

Memory (all ops)200 requests / minute per key
Live Data60 requests / minute per key
Register10 requests / hour per IP

Ready to integrate?

Get your API key and $0.50 in free credits in under 30 seconds.

Get API Key