REST API Integration

Get started with the infaza REST API in minutes. The API follows RESTful conventions and returns JSON responses with comprehensive error handling.

curl -X POST "https://api.infaza.dev/v1/memories" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": {
      "text": "Important project milestone achieved",
      "tags": ["project", "milestone"]
    },
    "agent_id": "your-agent-id",
    "importance": 0.8
  }'

infaza uses API key authentication with support for different access levels and permissions based on your subscription plan.

# Header Authentication
Authorization: Bearer sk_prod_abc123...

# Query Parameter (not recommended)
?api_key=sk_prod_abc123...

# Environment Variable
export infaza_API_KEY="sk_prod_abc123..."

Core endpoints for creating, retrieving, updating, and deleting memory entries with full CRUD operations.

{
  "content": {
    "text": "Memory content",
    "embedding": [0.1, 0.2, ...],
    "structured_data": {...},
    "media_refs": ["file-id"]
  },
  "metadata": {
    "tags": ["tag1", "tag2"],
    "importance": 0.8,
    "retention_policy": "30d"
  },
  "agent_id": "agent-id",
  "team_id": "team-id",
  "access_level": "private"
}

{
  "memory_id": "mem_abc123",
  "status": "created",
  "created_at": "2024-01-01T12:00:00Z",
  "encryption": {
    "algorithm": "homomorphic",
    "key_id": "key_xyz789"
  }
}

{
  "memory_id": "mem_abc123",
  "content": {...},
  "metadata": {...},
  "relationships": [...],
  "access_info": {
    "can_edit": true,
    "can_delete": false
  }
}

Powerful search capabilities including semantic search, temporal queries, and graph traversal for comprehensive memory retrieval.

{
  "query": "machine learning optimization",
  "limit": 10,
  "threshold": 0.8,
  "filters": {
    "agent_id": "specific-agent",
    "team_id": "team-id",
    "tags": ["ml", "optimization"],
    "date_range": {
      "start": "2024-01-01",
      "end": "2024-12-31"
    }
  },
  "include_content": true
}

{
  "results": [
    {
      "memory_id": "mem_abc123",
      "score": 0.95,
      "content": {...},
      "metadata": {...}
    }
  ],
  "total": 25,
  "query_time_ms": 45
}

Real-time notifications for memory updates, team changes, and workflow events with secure webhook delivery.

Official SDKs provide idiomatic integration for popular programming languages with built-in error handling and retry logic.

from infaza import infaza

client = infaza(api_key="...")
memory = client.memories.create({
  "content": {"text": "Hello"},
  "agent_id": "agent-123"
})

import { infaza } from '@infaza/sdk';

const client = new infaza({
  apiKey: process.env.infaza_API_KEY
});

const memory = await client.memories.create({
  content: { text: "Hello" },
  agentId: "agent-123"
});

import "github.com/infaza/go-sdk"

client := infaza.NewClient("api-key")
memory, err := client.Memories.Create(&infaza.CreateMemoryRequest{
  Content: map[string]interface{}{
    "text": "Hello",
  },
  AgentID: "agent-123",
})