Skip to main content

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.

​
Endpoint

GET /moments/{path}
Retrieve detailed information about a specific moment in the Clockchain graph, including all node attributes and connected edges.

​
Path Parameters

​
path
string
required
The full path to the moment, e.g. /1969/july/apollo-11-moon-landing

​
Query Parameters

​
format
string
default:"default"
Response format. Options:
  • default - Standard JSON response with full moment details and edges
  • tdf - Export as Timepoint Data Format (TDF) for interoperability

​
Authentication

Requires a valid service key via the verify_service_key dependency.

​
Response

​
Default Format

​
path
string
The unique path identifier for this moment
​
name
string
The display name of the moment
​
one_liner
string
A brief description or summary
​
year
integer
Year when the moment occurred
​
month
integer
Month when the moment occurred (1-12)
​
day
integer
Day of the month (1-31)
​
time
string
Time of day, if applicable
​
country
string
Country where the moment occurred
​
region
string
Region or state
​
city
string
City or locality
​
layer
integer
Graph layer (importance/depth indicator)
​
visibility
string
Visibility status: public or private
​
tags
array
List of thematic tags
​
figures
array
List of notable people associated with this moment
​
created_by
string
User ID or system identifier that created this moment
​
source_type
string
Source classification (e.g., historical, generated)
​
confidence
number
Confidence score for generated moments (0.0 to 1.0)
​
source_run_id
string
ID of the generation run that created this moment
​
tdf_hash
string
TDF content hash for deduplication and integrity
​
created_at
string
ISO 8601 timestamp when the moment was created
​
published_at
string
ISO 8601 timestamp when the moment was published
​
edges
array
List of edges connecting this moment to others

​
TDF Format

When format=tdf, returns a Timepoint Data Format record:
​
id
string
Moment identifier (path)
​
source
string
Always clockchain
​
timestamp
string
ISO 8601 creation timestamp
​
tdf_hash
string
Content-based hash for deduplication
​
provenance
object
Metadata about how this record was created
​
payload
object
The actual moment data (name, year, month, day, tags, etc.)

​
Examples

​
Get Moment (Default Format)

curl -X GET "https://api.timepoint.io/moments/1969/july/apollo-11-moon-landing" \
  -H "X-Service-Key: your_service_key"

{
  "path": "/1969/july/apollo-11-moon-landing",
  "name": "Apollo 11 Moon Landing",
  "one_liner": "First humans land on the Moon",
  "year": 1969,
  "month": 7,
  "day": 20,
  "time": "20:17 UTC",
  "country": "United States",
  "region": "",
  "city": "",
  "layer": 3,
  "visibility": "public",
  "tags": ["space", "exploration", "NASA", "moon"],
  "figures": ["Neil Armstrong", "Buzz Aldrin", "Michael Collins"],
  "created_by": "system",
  "source_type": "historical",
  "confidence": null,
  "source_run_id": null,
  "tdf_hash": "a3f8b2c9...",
  "created_at": "2024-01-15T10:30:00Z",
  "published_at": "2024-01-15T10:30:00Z",
  "edges": [
    {
      "source": "/1969/july/apollo-11-moon-landing",
      "target": "/1961/may/kennedy-moon-speech",
      "edge_type": "causes",
      "weight": 0.9,
      "theme": ""
    },
    {
      "source": "/1969/july/apollo-11-moon-landing",
      "target": "/1969/august/woodstock-festival",
      "edge_type": "contemporaneous",
      "weight": 0.5,
      "theme": ""
    }
  ]
}

​
Get Moment (TDF Format)

curl -X GET "https://api.timepoint.io/moments/1969/july/apollo-11-moon-landing?format=tdf" \
  -H "X-Service-Key: your_service_key"

{
  "id": "/1969/july/apollo-11-moon-landing",
  "source": "clockchain",
  "timestamp": "2024-01-15T10:30:00Z",
  "tdf_hash": "a3f8b2c9...",
  "provenance": {
    "generator": "timepoint-clockchain",
    "confidence": null,
    "run_id": null,
    "flash_id": null
  },
  "payload": {
    "name": "Apollo 11 Moon Landing",
    "year": 1969,
    "month": "july",
    "month_num": 7,
    "day": 20,
    "time": "20:17 UTC",
    "tags": ["space", "exploration", "NASA", "moon"],
    "figures": ["Neil Armstrong", "Buzz Aldrin", "Michael Collins"],
    "one_liner": "First humans land on the Moon",
    "layer": 3,
    "visibility": "public"
  }
}

​
Error Responses

​
404
error
Moment not found, or user lacks permission to view a private moment
{
  "detail": "Moment not found"
}
​
403
error
User is not authorized to view this private moment
{
  "detail": "Moment not found"
}
Note: Private moments return 404 instead of 403 to avoid leaking information about their existence.

​
Visibility Rules

  • Public moments: Accessible to all authenticated users
  • Private moments: Only accessible to the user who created them (created_by must match user_id)
  • If a moment is private and the requester is not the creator, a 404 error is returned (not 403, to prevent enumeration)

Build docs developers (and LLMs) love

Get started for freeTalk to us