← Back to DocsAPI Reference

Lexic.io API

Build powerful integrations with our RESTful API. Full access to notes, entities, and the knowledge graph.

Base URL

https://app.lexic.io/api/v1

API endpoints are served from the main application domain.

Authentication

Personal Access Tokens

For server-to-server integrations. Generate tokens in your workspace settings with customizable scopes.

Authorization: Bearer pat_xxxxxxxx_...

OAuth 2.0

For user-facing applications. Supports authorization code flow with PKCE.

Authorize: https://lexic.io/oauth/authorize

Rate Limits

1,000

requests/minute (Free)

10,000

requests/minute (Pro)

Custom

requests/minute (Enterprise)

Endpoints

GET/api/v1/notes

List all notes with pagination and filtering

POST/api/v1/notes

Create a new note with automatic entity extraction

GET/api/v1/notes/:id

Retrieve a specific note by ID

PUT/api/v1/notes/:id

Update an existing note

DELETE/api/v1/notes/:id

Delete a note (soft delete)

GET/api/v1/entities

List all extracted entities across notes

GET/api/v1/graph

Retrieve knowledge graph connections

POST/api/v1/search

Semantic search across your knowledge base

GET/api/v1/usage

Get current word usage and remaining allocation

Quick Example

Create a note

curl -X POST https://app.lexic.io/api/v1/notes \
  -H "Authorization: Bearer pat_xxxxxxxx_your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Meeting with Product Team",
    "content": "Discussed Q2 roadmap with Sarah and Mike...",
    "extractEntities": true
  }'

Response

200 OK

{
  "id": "note_abc123",
  "title": "Meeting with Product Team",
  "content": "Discussed Q2 roadmap with Sarah and Mike...",
  "entities": [
    { "type": "person", "name": "Sarah", "id": "ent_xyz" },
    { "type": "person", "name": "Mike", "id": "ent_uvw" },
    { "type": "concept", "name": "Q2 roadmap", "id": "ent_rst" }
  ],
  "wordsProcessed": 847,
  "createdAt": "2025-01-15T10:30:00Z"
}

← Audit Logs

API Tokens →