REST API

A complete, generated HTTP contract.

Use stable resource URLs, JSON bodies, documented errors, idempotent writes, and optimistic concurrency without learning an app-specific client library.

Create an event

POST https://api.twelvemonthcalendar.com/v1/events
Authorization: Bearer tmc_…
Idempotency-Key: 018f…
Content-Type: application/json

{
  "calendar_id": "cal_…",
  "title": "Paris",
  "when": {
    "kind": "all_day",
    "start_date": "2027-10-04",
    "end_date": "2027-10-10"
  },
  "category_id": "cat_…",
  "person_ids": ["per_…"]
}