curl --request POST \
--url https://api.example.com/api/generate{
"job_id": "<string>",
"status": "<string>",
"created_at": "<string>",
"path": {},
"error": {},
"completed_at": {}
}Create a new historical moment from a text query using Flash Timepoint API
curl --request POST \
--url https://api.example.com/api/generate{
"job_id": "<string>",
"status": "<string>",
"created_at": "<string>",
"path": {},
"error": {},
"completed_at": {}
}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.
/generate endpoint accepts a natural language query describing a historical event and returns a job ID. The system uses the Flash Timepoint API to generate structured moment data, which is then indexed into the Clockchain graph.
SERVICE_API_KEY header for authentication.
X-Service-Key: your-service-api-key
default - Standard generationbalanced - Balanced quality and speeddetailed - Maximum detail and accuracyprivate - Only visible to creatorpublic - Visible to all userspending immediately after creation.Possible values:pending - Job created, waiting to processprocessing - Currently generating momentcompleted - Successfully generated and indexedfailed - Generation failed (check error field)completed.Format: /YYYY/month/DD/HHMM/country/region/city/event-slugfailed. Otherwise null.null while processing.curl -X POST https://api.clockchain.io/api/generate \
-H "Content-Type: application/json" \
-H "X-Service-Key: your-service-api-key" \
-d '{
"query": "Signing of the Declaration of Independence July 4 1776",
"preset": "balanced",
"visibility": "private"
}'
{
"job_id": "a3d8f7e2-4c1b-4a9e-8f2d-1e3c5b7a9d0f",
"status": "pending",
"path": null,
"error": null,
"created_at": "2026-03-06T14:32:18.123456Z",
"completed_at": null
}
OPENROUTER_API_KEY is configured, queries are screened by a content judge before processing. Inappropriate queries will be rejected with a 400 error.job_id from the responsestatus is completed, use the path to fetch moment details| Status Code | Description |
|---|---|
| 400 | Query rejected by content judge |
| 401 | Missing or invalid SERVICE_API_KEY |
| 503 | Job manager not available |