Documentation Index
Fetch the complete documentation index at: https://mintlify.com/timepoint-ai/timepoint-clockchain/llms.txt
Use this file to discover all available pages before exploring further.
Introduction
The Timepoint Clockchain API provides access to historical moments, graph navigation, content generation, and data ingestion capabilities. All endpoints require authentication via service key.Base URL
The API version is
0.1.0 and all endpoints are prefixed with /api/v1.Available Endpoints
Moments
Retrieve and manage historical moment data.- GET
/moments/{path}- Retrieve a specific moment by path - GET
/browse- Browse the root level of moments - GET
/browse/{path}- Browse moments at a specific path - GET
/today- Get moments that occurred on today’s date in history - GET
/random- Retrieve a random public moment - GET
/search- Search moments by query string
Graph
Access the knowledge graph structure and relationships.- GET
/graph/neighbors/{path}- Get neighboring nodes for a specific path - GET
/stats- Retrieve graph statistics (node and edge counts)
Generation
Generate new moments and manage jobs.- POST
/generate- Generate a new moment from a query - GET
/jobs/{job_id}- Check the status of a generation job - POST
/moments/{path}/publish- Publish a moment (change visibility) - POST
/bulk-generate- Generate multiple moments (requires admin key) - POST
/expand-once- Manually trigger graph expansion (requires OpenRouter API key) - POST
/index- Index a moment with metadata
Ingestion
Import external data into the graph.- POST
/ingest/subgraph- Ingest a complete subgraph (nodes and edges) - POST
/ingest/tdf- Ingest TDF (Timepoint Data Format) records
Health & Status
The API also provides public endpoints for service health:- GET
/- Service information and version - GET
/health- Health check with graph statistics
The
/ and /health endpoints do not require authentication.Response Formats
All endpoints return JSON responses. The API uses standard HTTP status codes:200- Success400- Bad request (invalid parameters)403- Forbidden (invalid authentication)404- Resource not found503- Service unavailable (configuration issue)
Special Query Parameters
Format Parameter
The/moments/{path} endpoint supports a format query parameter:
Response format:
default or tdf (Timepoint Data Format)Search Parameter
The/search endpoint requires a query string:
Search query (minimum 1 character)
User Context
Endpoints that support user-specific operations accept an optionalX-User-Id header to filter or manage user-created content. See the Authentication page for details.
Next Steps
Authentication
Learn how to authenticate your API requests