Skip to content

Notion: Meeting notes schemas

4 Notion schemas with complete fields and constraints.

← Meeting notes operations · All schemas

Create a meeting note — response body — object block, type meeting notes

FieldTypePresenceDescription and constraints
$objectRootAdditional keys: allowed
created_byModelRequired within parentExpand Update page — response body — object page created by
User who created this meeting note.
created_timestringRequired within parentISO-8601 timestamp when this meeting note was created.
has_childrenbooleanRequired within parentWhether this block has child blocks.
idstringRequired within parentThe ID of the meeting note block.
Format: uuid
in_trashbooleanRequired within parentWhether this meeting note is in the trash.
last_edited_byModelRequired within parentExpand Update page — response body — object page created by
User who last edited this meeting note.
last_edited_timestringRequired within parentISO-8601 timestamp when this meeting note was last edited.
meeting_notesModelRequired within parentExpand Create a meeting note — response body — object block, type meeting notes meeting notes
objectstringRequired within parentAlways "block".
Must equal: block
typestringRequired within parentAlways "meeting_notes".
Must equal: meeting_notes

Referenced models: Update page — response body — object page created by, Create a meeting note — response body — object block, type meeting notes meeting notes

Create a meeting note — response body — object block, type meeting notes meeting notes

FieldTypePresenceDescription and constraints
$objectRootMeeting note content fields.
Additional keys: allowed
calendar_eventModelOptionalExpand Create a meeting note — response body — object block, type meeting notes meeting notes calendar event
childrenobjectOptionalBlock IDs for each tab (summary, notes, transcript).
Additional keys: allowed
children.notes_block_idstringOptionalBlock ID of the meeting notes tab.
Format: uuid
children.summary_block_idstringOptionalBlock ID of the AI summary tab.
Format: uuid
children.transcript_block_idstringOptionalBlock ID of the transcript tab.
Format: uuid
is_full_pagebooleanRequired within parentWhether this is a full-page meeting note.
recordingobjectOptionalStart and end times of the actual recording.
Additional keys: allowed
recording.end_timestringOptionalISO-8601 timestamp when the recording ended.
recording.start_timestringOptionalISO-8601 timestamp when the recording started.
statusstringOptionalCurrent processing status of the meeting note transcription.
Known values: transcription_not_started, transcription_paused, transcription_in_progress, transcription_failed, summary_in_progress, notes_ready
titlearrayOptionalTitle of the meeting note as rich text.
Maximum items: 100
title[]ModelEach itemExpand Retrieve a page property item — response body — value Title title

Referenced models: Retrieve a page property item — response body — value Title title, Create a meeting note — response body — object block, type meeting notes meeting notes calendar event

Create a meeting note — response body — object block, type meeting notes meeting notes calendar event

FieldTypePresenceDescription and constraints
$objectRootCalendar event metadata associated with this meeting note.
Additional keys: allowed
attendeesarrayOptionalList of attendee user IDs.
Maximum items: 100
attendees[]stringEach itemFormat: uuid
end_timestringRequired within parentISO-8601 end time of the calendar event.
event_idstringOptionalID of the calendar event, as returned by the calendar tools.
start_timestringRequired within parentISO-8601 start time of the calendar event.

Query meeting notes — request body — body filter filters item filter, property

FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed
filterJSONRequired within parentThe comparison to apply. Use the arm matching the property's type.
filter (oneOf 1)objectAlternativeAdditional keys: not allowed
filter (oneOf 1).operatorstringRequired within parentHow to compare the text.
One of: string_is, string_is_not, string_contains, string_does_not_contain, string_starts_with, string_ends_with
filter (oneOf 1).valueobjectRequired within parentThe text to compare against.
Additional keys: not allowed
filter (oneOf 1).value.typestringRequired within parentAlways `exact`
Must equal: exact
filter (oneOf 1).value.valuestringRequired within parentThe literal text the operator compares against.
filter (oneOf 2)objectAlternativeAdditional keys: not allowed
filter (oneOf 2).operatorstringRequired within parentWhether the property must contain the people listed.
One of: person_contains, person_does_not_contain
filter (oneOf 2).valuearrayRequired within parentThe people to compare against.
Maximum items: 100
filter (oneOf 2).value[]JSONEach item
filter (oneOf 2).value[] (oneOf 1)objectAlternativeAdditional keys: not allowed
filter (oneOf 2).value[] (oneOf 1).typestringRequired within parentAlways `exact`
Must equal: exact
filter (oneOf 2).value[] (oneOf 1).valueobjectRequired within parentPointer to the Notion user to match.
Additional keys: not allowed
filter (oneOf 2).value[] (oneOf 1).value.idstringRequired within parentThe user's ID, as a UUID or the `user://<uuid>` form returned by user search.
filter (oneOf 2).value[] (oneOf 1).value.tablestringRequired within parentAlways `notion_user`
Must equal: notion_user
filter (oneOf 2).value[] (oneOf 2)objectAlternativeAdditional keys: not allowed
filter (oneOf 2).value[] (oneOf 2).typestringRequired within parentAlways `relative`
Must equal: relative
filter (oneOf 2).value[] (oneOf 2).valuestringRequired within parentAlways `me`
Must equal: me
filter (oneOf 3)objectAlternativeAdditional keys: not allowed
filter (oneOf 3).operatorstringRequired within parentHow to compare the date.
One of: date_is, date_is_before, date_is_after, date_is_on_or_before, date_is_on_or_after
filter (oneOf 3).use_endbooleanOptionalCompare against the end of a date range rather than its start.
filter (oneOf 3).valueJSONRequired within parentThe date to compare against.
filter (oneOf 3).value (oneOf 1)objectAlternativeAdditional keys: not allowed
filter (oneOf 3).value (oneOf 1).typestringRequired within parentAlways `relative`
Must equal: relative
filter (oneOf 3).value (oneOf 1).valuestringRequired within parentOne of: `today`, `tomorrow`, `yesterday`, `one_week_ago`, `one_week_from_now`, `one_month_ago`, `one_month_from_now`
One of: today, tomorrow, yesterday, one_week_ago, one_week_from_now, one_month_ago, one_month_from_now
filter (oneOf 3).value (oneOf 2)objectAlternativeAdditional keys: not allowed
filter (oneOf 3).value (oneOf 2).typestringRequired within parentAlways `exact`
Must equal: exact
filter (oneOf 3).value (oneOf 2).valueJSONRequired within parentUse the is_empty operator to match an unset date.
filter (oneOf 3).value (oneOf 2).value (oneOf 1)objectAlternativeAdditional keys: not allowed
filter (oneOf 3).value (oneOf 2).value (oneOf 1).start_datestringRequired within parentThe calendar date as an ISO 8601 date string.
Format: date
filter (oneOf 3).value (oneOf 2).value (oneOf 1).typestringRequired within parentAlways `date`
Must equal: date
filter (oneOf 3).value (oneOf 2).value (oneOf 2)objectAlternativeAdditional keys: not allowed
filter (oneOf 3).value (oneOf 2).value (oneOf 2).start_datestringRequired within parentThe calendar date as an ISO 8601 date string.
Format: date
filter (oneOf 3).value (oneOf 2).value (oneOf 2).start_timestringRequired within parentThe time of day in 24-hour HH:MM format.
filter (oneOf 3).value (oneOf 2).value (oneOf 2).time_zonestringRequired within parentThe IANA time zone name the time is interpreted in.
filter (oneOf 3).value (oneOf 2).value (oneOf 2).typestringRequired within parentAlways `datetime`
Must equal: datetime
filter (oneOf 4)objectAlternativeAdditional keys: not allowed
filter (oneOf 4).operatorstringRequired within parentHow to compare the date against the range.
One of: date_is_within, date_is_relative_to
filter (oneOf 4).use_endbooleanOptionalCompare against the end of a date range rather than its start.
filter (oneOf 4).valueJSONRequired within parentThe range to compare against.
filter (oneOf 4).value (oneOf 1)objectAlternativeAdditional keys: not allowed
filter (oneOf 4).value (oneOf 1).countintegerRequired within parentHow many units wide the window is.
Minimum: 1
filter (oneOf 4).value (oneOf 1).directionstringRequired within parentWhether the window runs backwards or forwards from now.
One of: past, future
filter (oneOf 4).value (oneOf 1).typestringRequired within parentAlways `relative`
Must equal: relative
filter (oneOf 4).value (oneOf 1).unitstringRequired within parentOne of: `year`, `month`, `week`, `day`
One of: year, month, week, day
filter (oneOf 4).value (oneOf 1).valuestringRequired within parentAlways `custom`
Must equal: custom
filter (oneOf 4).value (oneOf 2)objectAlternativeAdditional keys: not allowed
filter (oneOf 4).value (oneOf 2).typestringRequired within parentAlways `relative`
Must equal: relative
filter (oneOf 4).value (oneOf 2).unitstringRequired within parentOne of: `year`, `month`, `week`, `day`
One of: year, month, week, day
filter (oneOf 4).value (oneOf 2).valuestringRequired within parentAlways `surrounding`
Must equal: surrounding
filter (oneOf 4).value (oneOf 3)objectAlternativeAdditional keys: not allowed
filter (oneOf 4).value (oneOf 3).typestringRequired within parentAlways `relative`
Must equal: relative
filter (oneOf 4).value (oneOf 3).valuestringRequired within parentOne of: `this_week`, `the_past_week`, `the_past_month`, `the_past_year`, `the_next_week`, `the_next_month`, `the_next_year`
One of: this_week, the_past_week, the_past_month, the_past_year, the_next_week, the_next_month, the_next_year
filter (oneOf 4).value (oneOf 4)objectAlternativeAdditional keys: not allowed
filter (oneOf 4).value (oneOf 4).typestringRequired within parentAlways `exact`
Must equal: exact
filter (oneOf 4).value (oneOf 4).valueobjectRequired within parentUse the is_empty operator to match an unset date.
Additional keys: not allowed
filter (oneOf 4).value (oneOf 4).value.end_datestringOptionalInclusive end of the range as an ISO 8601 date string, if any.
Format: date
filter (oneOf 4).value (oneOf 4).value.start_datestringOptionalInclusive start of the range as an ISO 8601 date string, if any.
Format: date
filter (oneOf 4).value (oneOf 4).value.typestringRequired within parentAlways `daterange`
Must equal: daterange
filter (oneOf 5)objectAlternativeAdditional keys: not allowed
filter (oneOf 5).operatorstringRequired within parentWhether the property must be empty or set.
One of: is_empty, is_not_empty
propertystringRequired within parentWhich meeting-note property to filter on. Prefer the short names; the schema URI form is accepted for compatibility.
One of: title, attendees, created_time, created_by, last_edited_time, last_edited_by, notion://meeting_notes/attendees

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.