GET /entities/:appId/:userId

curl "https://api.magneteco.io/v1/entities/tanda/user-123?type=Client&limit=10" \
  -H "Authorization: Bearer $API_KEY"

{
  "entities": [
    {
      "name": "Acme Corp",
      "type": "Client",
      "properties": {
        "industry": "Manufacturing",
        "size": "Enterprise"
      },
      "relationshipCount": 5,
      "firstMentioned": "2024-01-01T00:00:00Z",
      "lastMentioned": "2024-01-15T14:30:00Z"
    }
  ],
  "total": 1,
  "hasMore": false
}

GET /entities/:appId/:userId/:entityName

curl "https://api.magneteco.io/v1/entities/tanda/user-123/Acme%20Corp" \
  -H "Authorization: Bearer $API_KEY"

{
  "entity": {
    "name": "Acme Corp",
    "type": "Client",
    "properties": {
      "industry": "Manufacturing",
      "size": "Enterprise",
      "location": "Chicago, IL"
    },
    "relationships": [
      {
        "type": "OWNS",
        "direction": "outgoing",
        "target": "NetSuite Implementation",
        "targetType": "Project",
        "properties": { "since": "2024-01-01" }
      },
      {
        "type": "HAS_CONTACT",
        "direction": "outgoing",
        "target": "Jane Smith",
        "targetType": "Contact",
        "properties": { "role": "Project Sponsor" }
      }
    ],
    "mentions": [
      {
        "context": "Working with Acme Corp on NetSuite...",
        "timestamp": "2024-01-15T14:30:00Z"
      }
    ]
  }
}

POST /forget

{
  "appId": string,           // Required: Your app identifier
  "userId": string,          // Required: User to forget
  "category"?: string,       // Optional: Delete specific category only
  "confirm": boolean         // Required: Must be true
}

# Delete all memories for a user
curl -X POST https://api.magneteco.io/v1/forget \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "appId": "tanda",
    "userId": "user-123",
    "confirm": true
  }'

# Delete specific category
curl -X POST https://api.magneteco.io/v1/forget \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "appId": "tanda",
    "userId": "user-123",
    "category": "personal_info",
    "confirm": true
  }'

{
  "status": "deleted",
  "deletedItems": 47,
  "deletedEntities": 12,
  "deletedResources": 15
}

GET /health

{
  "status": "healthy",
  "components": {
    "postgres": { "status": "healthy", "latency": 12 },
    "neo4j": { "status": "healthy", "latency": 45 },
    "s3": { "status": "healthy" },
    "sqs": { "status": "healthy", "queueDepth": 23 }
  },
  "version": "1.0.0",
  "uptime": 86400
}