# blink / by FractionML (/ ml) — Developer & Agent Documentation

> Sub-10ms neural and symbolic memory API for AI agents, IDE copilots, and enterprise RAG. 100% 1:1 drop-in compatible with Mem0 (all 68 endpoints) plus native `/v1/blink/*` high-speed endpoints.

## Base URLs & Machine-Readable Specs
- Production API Base URL: `https://api.fractionml.com`
- Documentation Portal: `https://docs.fractionml.com`
- Full Self-Contained Agent Markdown: `https://docs.fractionml.com/llms-full.txt`
- OpenAPI 3.1 Specification: `https://docs.fractionml.com/openapi.json`
- Live System Status: `https://status.fractionml.com` (JSON: `https://status.fractionml.com/status.json`)

## Authentication (Required on all API calls)
Pass your API key (`bk_live_...`) using any of these headers:
- `Authorization: Bearer <BLINK_API_KEY>`
- `Authorization: Token <BLINK_API_KEY>` (default used by `mem0ai` SDK)
- `X-API-Key: <BLINK_API_KEY>`

## Quick API Index (Self-Contained in `/llms-full.txt`)
- Native Blink API:
  - `POST https://api.fractionml.com/v1/blink/ingest` — Ingest documents/code snippets with metadata
  - `POST https://api.fractionml.com/v1/blink/query` — Sub-10ms semantic & symbolic retrieval
  - `DELETE https://api.fractionml.com/v1/blink/forget` — Deterministic memory & GDPR erasure
  - `GET https://api.fractionml.com/healthz` — Gateway health check
  - `GET https://api.fractionml.com/health/synthetic` — End-to-end synthetic canary probe
- Mem0 1:1 Drop-In Memory API:
  - `POST https://api.fractionml.com/v1/memories/` — Add memories from `messages` or `text`
  - `POST https://api.fractionml.com/v2/memories/search/` — Search memories with Boolean Filter DSL (`AND`, `OR`, `NOT`)
  - `POST https://api.fractionml.com/v1/memories/search/` — Search memories (v1)
  - `GET https://api.fractionml.com/v1/memories/` — List memories (paginated)
  - `POST https://api.fractionml.com/v2/memories/` — List memories with v2 filter tree
  - `GET https://api.fractionml.com/v1/memories/{memory_id}/` — Get single memory
  - `PUT https://api.fractionml.com/v1/memories/{memory_id}/` — Update single memory
  - `GET https://api.fractionml.com/v1/memories/{memory_id}/history/` — Get memory revision history
  - `DELETE https://api.fractionml.com/v1/memories/{memory_id}/` — Delete single memory
  - `DELETE https://api.fractionml.com/v1/memories/` — Delete scoped memories
  - `PUT https://api.fractionml.com/v1/batch/` — Batch update up to 1,000 memories
  - `DELETE https://api.fractionml.com/v1/batch/` — Batch delete up to 1,000 memories
- Control Plane, Entities, Webhooks & Lifecycle API:
  - `POST / GET / DELETE https://api.fractionml.com/api/v1/orgs/organizations/` — Organizations CRUD
  - `POST / GET / PATCH / DELETE https://api.fractionml.com/api/v1/orgs/organizations/{org_id}/projects/` — Projects CRUD
  - `GET / DELETE https://api.fractionml.com/v1/entities/` — Entities directory & cascade delete
  - `POST / GET / PUT / DELETE https://api.fractionml.com/api/v1/webhooks/projects/{project_id}/` — Webhooks CRUD
  - `GET https://api.fractionml.com/v1/event/{event_id}/` — Event status lookup
  - `POST https://api.fractionml.com/v1/exports/` & `POST https://api.fractionml.com/v1/exports/get` — Structured exports
  - `POST https://api.fractionml.com/v1/feedback/` — Relevance feedback
  - `POST https://api.fractionml.com/v1/memories/consolidate/` — Memory deduplication & consolidation