API Reference
Complete reference for all Hebbrix API endpoints. All endpoints require authentication via API key in the Authorization header.
Base URL
https://api.hebbrix.com/v1All API requests should be made to this base URL. HTTPS is required.
Authentication
Include your API key in the Authorization header:
Authorization: Bearer mem_sk_your_api_keyResources
Memories
Create, retrieve, update, and delete memory entries
/v1/memories
Search
Semantic and hybrid search across memories
/v1/search
Chat Completions
OpenAI-compatible chat with memory injection
/v1/chat
Collections
Organize memories into collections
/v1/collections
Documents
Upload and process documents
/v1/documents
Profile
User profile and preferences
/v1/profile
Knowledge Graph
Entities and relationships
/v1/knowledge-graph
Webhooks
Event notifications
/v1/webhooks
Usage & Billing
Monitor usage and manage subscription
/v1/usage
All Endpoints
Memories
| POST | /v1/memories |
| POST | /v1/memories/raw |
| POST | /v1/memories/process |
| POST | /v1/memories/batch |
| GET | /v1/memories |
| GET | /v1/memories/{id} |
| PATCH | /v1/memories/{id} |
| DELETE | /v1/memories/{id} |
| POST | /v1/memories/bulk-delete |
| DELETE | /v1/memories/all |
Search
| POST | /v1/search |
| POST | /v1/search/advanced |
| GET | /v1/search/similar/{id} |
| POST | /v1/search/graph |
| POST | /v1/search/reason |
Chat Completions
| POST | /v1/chat/completions |
Collections
| POST | /v1/collections |
| GET | /v1/collections |
| GET | /v1/collections/default |
| GET | /v1/collections/{id} |
| PATCH | /v1/collections/{id} |
| DELETE | /v1/collections/{id} |
| POST | /v1/collections/bulk-delete |
| DELETE | /v1/collections/all |
Documents
| POST | /v1/documents |
| GET | /v1/documents |
| GET | /v1/documents/{id} |
| GET | /v1/documents/{id}/chunks |
| DELETE | /v1/documents/{id} |
Profile
| GET | /v1/profile |
| PATCH | /v1/profile |
| POST | /v1/profile/dialectic |
| DELETE | /v1/profile |
Knowledge Graph
| GET | /v1/knowledge-graph/entities |
| GET | /v1/knowledge-graph/entities/{entity_name} |
| POST | /v1/knowledge-graph/entities |
| DELETE | /v1/knowledge-graph/entities/{entity_name} |
| POST | /v1/knowledge-graph/relationships |
| DELETE | /v1/knowledge-graph/relationships |
| POST | /v1/knowledge-graph/query |
Webhooks
| POST | /v1/webhooks |
| GET | /v1/webhooks |
| GET | /v1/webhooks/{id} |
| PUT | /v1/webhooks/{id} |
| DELETE | /v1/webhooks/{id} |
| POST | /v1/webhooks/{id}/test |
Usage & Billing
| GET | /v1/usage |
| GET | /v1/usage/history |
| GET | /v1/billing/subscription |
| POST | /v1/billing/upgrade |
| POST | /v1/billing/downgrade |
| GET | /v1/billing/invoices |
Response Format
All responses are JSON. Successful responses include the requested data:
{
"id": "mem_abc123",
"content": "User prefers...",
"created_at": "2024-01-15T..."
}{
"error": {
"code": "invalid_request",
"message": "...",
"status": 400
}
}Pagination
List endpoints use cursor-based pagination with limit and cursor parameters:
GET /v1/memories?limit=50&cursor=eyJpZCI6Im1lbV8xMjMifQ| Parameter | Default | Max | Description |
|---|---|---|---|
limit | 50 | 100 | Number of items to return |
cursor | null | - | Cursor from previous response's next_cursor field |
Response includes pagination metadata:
{
"items": [...],
"next_cursor": "eyJpZCI6Im1lbV83ODkifQ",
"has_more": true,
"total_count": 1250
}Rate Limits
Rate limits vary by tier and endpoint. Check response headers for your current limits:
X-RateLimit-LimitMax requests
X-RateLimit-RemainingRemaining requests
X-RateLimit-ResetReset timestamp
Retry-AfterWait time (on 429)
Get Started
Ready to start building? Check out our quickstart guide or explore the SDKs.