Resource

Meetings

Calendar events created by Cold OS.

Endpoints · 2

Read · GET

Fetch data — accept query filters, return JSON. Read-only and idempotent.

GET
List meetings
/v1/meetings
/v1/meetings

Create · POST

Create new records. Send a JSON body; the response is the created resource.

POST
Schedule a meeting
/v1/meetings
/v1/meetings
Creates a calendar event on the API key owner's Google Calendar. Adds a Google Meet link by default. Auto-spawns a 30-minute prep task. Returns immediately with `status: "scheduling"`; the outbox handler stamps `scheduled` once the calendar insert completes.

Object shape

The meetings object

Cold OS WRITES events to the operator's Google Calendar via the outbox. The read-only pull sync is paused (`CALENDAR_SYNC_DISABLED = true`) — every meeting in this resource was created by Cold OS.

Meetings object

{
  "id": "01HZS6X0Y9Z8W7V6U5T4S3R2Q1",
  "contact_id": "c2a8a93a-2f1c-4c5b-8f3d-9c1e3a8b5d12",
  "organizer_id": "b1f2c3d4-5678-90ab-cdef-1234567890ab",
  "title": "Cold OS x Acme — pipeline walkthrough",
  "description": "30-min pipeline walkthrough; bring the Q2 dashboard.",
  "status": "scheduled",
  "outcome": null,
  "starts_at": "2026-05-04T16:00:00.000+05:30",
  "ends_at": "2026-05-04T16:30:00.000+05:30",
  "meeting_url": "https://meet.google.com/abc-defg-hij",
  "google_calendar_event_id": "abcdefghijklmnop1234567890",
  "attendees": [
    "ankit@example.com",
    "polymath@justgotwyrd.com"
  ]
}

Was this page helpful?

Your vote stays in this browser. We'll use it to prioritise rewrites.