REST API Reference

The Engram API provides programmatic access to all features of the semantic search system.

Base URL

http://localhost:8000/api

The API uses JWT bearer token authentication. Include the token in the Authorization header:

Authorization: Bearer <your-token>

tip

You can also download the OpenAPI specification directly for use with API clients like Postman or Insomnia.

Endpoint	Method	Description
`/api/conversations`	GET	List conversations
`/api/conversations`	POST	Create conversation
`/api/conversations/{id}`	GET	Get conversation
`/api/conversations/{id}`	DELETE	Delete conversation
`/api/conversations/{id}/messages`	GET	List messages
`/api/conversations/{id}/messages`	POST	Create message
`/api/conversations/{id}/chat`	POST	Stream chat

Endpoint	Method	Description
`/api/timeline`	GET	List timeline events

All responses are JSON formatted:

{
  "data": { ... },
  "meta": {
    "total": 100,
    "page": 1,
    "per_page": 20
  }
}

Errors return appropriate HTTP status codes with a JSON body:

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters",
    "details": { ... }
  }
}