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/graph
Webhooks
Event notifications
/v1/webhooks
Usage & Billing
Monitor usage and manage subscription
/v1/usage
All Endpoints
Memories
| POST | /v1/memories |
| GET | /v1/memories |
| GET | /v1/memories/{id} |
| PATCH | /v1/memories/{id} |
| DELETE | /v1/memories/{id} |
| POST | /v1/memories/batch |
Search
| POST | /v1/search |
| POST | /v1/search/similar |
| POST | /v1/search/graph |
Chat Completions
| POST | /v1/chat/completions |
Collections
| POST | /v1/collections |
| GET | /v1/collections |
| GET | /v1/collections/{id} |
| PATCH | /v1/collections/{id} |
| DELETE | /v1/collections/{id} |
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/graph/entities |
| GET | /v1/graph/entities/{id} |
| POST | /v1/graph/entities |
| POST | /v1/graph/relationships |
| POST | /v1/graph/query |
Webhooks
| POST | /v1/webhooks |
| GET | /v1/webhooks |
| GET | /v1/webhooks/{id} |
| PATCH | /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 support pagination with limit and offset parameters:
GET /v1/memories?limit=50&offset=100| Parameter | Default | Max | Description |
|---|---|---|---|
limit | 50 | 100 | Number of items to return |
offset | 0 | - | Number of items to skip |
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.