v1

latestOpenAPI 3.0.12026-07-268028223.9 KB

Meetings

Create a meeting

Create a new meeting. Only past meetings can be logged via the API.

post/v1/meetings

Headers

Idempotency-Keystring

Unique key to ensure idempotent request handling. If a request with the same key was already processed, the original response will be returned.

Request body

book_idstring required

The book ID

titlestring required

Meeting title

start_timestring date-time required

Meeting start time (ISO8601). Must be in the past.

end_timestring date-time

Meeting end time (ISO8601)

notepadstring

Meeting notes (markdown)

household_idsstring[]

Array of household IDs to link to this meeting

Example request

{
  "book_id": "abc123xyz",
  "title": "Client Review",
  "start_time": "2024-01-15T10:00:00Z",
  "end_time": "2024-01-15T11:00:00Z",
  "notepad": "## Agenda\\n\\n- Review portfolio"
}

Response

meeting created

idstring required

titlestring required

start_timestring date-time nullable

end_timestring date-time nullable

duration_secondsinteger

meeting_linkstring nullable

meeting_source'instant' | 'calendar_event' | 'imported' | 'logged' nullable

meeting_typestring

book_idstring required

has_transcriptboolean required

has_recordingsboolean required

quick_summarystring nullable

ai_summarystring nullable

notepadstring nullable

created_atstring date-time required

updated_atstring date-time required