Creates a new note within the specified workspace (team_id).
The note object is provided in the request body, including the note title, content,
and any other relevant details (optional fields include transcript and user notes).
Upon successful creation, the new note is returned in the response.
Initial transcript entries with the same client_chunk_id and exact content/source are
collapsed in their original order; conflicting payloads for the same ID reject the
entire request with 409 before creating the note. Entries without an ID retain legacy
behavior. A client_chunk_id does not make note creation idempotent.
Optional id for the new note, so your app can open the note before
the request finishes. Retrying with the same key returns the note
already created instead of making another. The server generates an
id when omitted. Must be a lowercase version 7 UUID; any other
value, or the id of an existing or deleted note, is rejected with a
400.
Per-note PII redaction selection. Omission or null preserves unredacted behavior for older clients and defaults to false; supported clients explicitly initialize this from the personal transcription_auto_redact_pii setting.
Normalized meeting data for Notes. IDs must be stable across Microsoft
sync and updates; consumers qualify them by provider, account and calendar.
Note create/update must re-fetch the selected event through this user's
installation and persist only the server-verified event, not caller-supplied
meeting contents.
Show child attributes
Response
The note was already created with this Idempotency-Key and is returned.
{
"error": {
"id": "err5f744ab",
"code": 403,
"sec": "SEC:000-00014",
"message": "You do not have access to this resource",
"date": 1608742037016
}
}
{
"error": {
"id": "err5f744ab",
"code": 403,
"sec": "SEC:000-00014",
"message": "You do not have access to this resource",
"date": 1608742037016
}
}
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Superthread help center","colors":{"primary":"#6366F1","light":"#818CF8","dark":"#4F46E5"},"logo":{"light":"https://mintcdn.com/superthread/8Pe5qUtfxBYjsAW7/logo/light.svg?fit=max\u0026auto=format\u0026n=8Pe5qUtfxBYjsAW7\u0026q=85\u0026s=3ec799023892643fb9a9173e31d2cbc2","dark":"https://mintcdn.com/superthread/8Pe5qUtfxBYjsAW7/logo/dark.svg?fit=max\u0026auto=format\u0026n=8Pe5qUtfxBYjsAW7\u0026q=85\u0026s=625cf090d83eb1dec08a314f090bd129","href":"https://superthread.com"},"favicon":"https://mintcdn.com/superthread/8Pe5qUtfxBYjsAW7/favicon.svg?fit=max\u0026auto=format\u0026n=8Pe5qUtfxBYjsAW7\u0026q=85\u0026s=fa1ffa91a2c500722dd37a97c85c7cd5","navbar":{"links":[{"href":"mailto:support@superthread.com","label":"Support"}],"primary":{"type":"button","label":"Try Superthread","href":"https://superthread.com"}},"footer":{"socials":{"x":"https://x.com/superthread_","github":"https://github.com/superthread","linkedin":"https://www.linkedin.com/company/superthread"}},"styling":{"latex":false},"navigation":{"global":{},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"superthread","hasAudioNarration":false,"actualSubdomain":"superthread","customDomains":["superthread.com"],"gitSource":{"type":"github","owner":"superthread-com","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae4b20ec2eaceb0e3453ecd","collectionId":"c94ba425-32c1-4085-8be9-fa6e54af31f2","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae4b20ec2eaceb0e3453ecd"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae4b20ec2eaceb0e3453ecd","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"API docs","count":123},{"language":"default","tag":"Help","count":45},{"language":"default","tag":"Time tracking","count":34},{"language":"default","tag":"Cards","count":14},{"language":"default","tag":"Platform \u0026 integrations","count":12},{"language":"default","tag":"Notes","count":10},{"language":"default","tag":"Pages","count":10},{"language":"default","tag":"Projects","count":10},{"language":"default","tag":"Task management","count":10},{"language":"default","tag":"Comments","count":9}]},"assistantConfig":{"enableAskAiButton":true,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-docs/notes/create-a-note","slug":"/api-docs/notes/create-a-note","pageMetadata":{"title":"Create a note","openapi":"POST /{team_id}/notes","description":"Creates a new note within the specified workspace (team_id).\nThe note object is provided in the request body, including the note title, content,\nand any other relevant details (optional fields include transcript and user notes).\nUpon successful creation, the new note is returned in the response.\nInitial transcript entries with the same client_chunk_id and exact content/source are\ncollapsed in their original order; conflicting payloads for the same ID reject the\nentire request with 409 before creating the note. Entries without an ID retain legacy\nbehavior. A client_chunk_id does not make note creation idempotent.\n","href":"/api-docs/notes/create-a-note"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Creates a new note within the specified workspace (team_id).\\nThe note object is provided in the request body, including the note title, content,\\nand any other relevant details (optional fields include transcript and user notes).\\nUpon successful creation, the new note is returned in the response.\\nInitial transcript entries with the same client_chunk_id and exact content/source are\\ncollapsed in their original order; conflicting payloads for the same ID reject the\\nentire request with 409 before creating the note. Entries without an ID retain legacy\\nbehavior. A client_chunk_id does not make note creation idempotent.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a note","openapi":"POST /{team_id}/notes","description":"Creates a new note within the specified workspace (team_id).\nThe note object is provided in the request body, including the note title, content,\nand any other relevant details (optional fields include transcript and user notes).\nUpon successful creation, the new note is returned in the response.\nInitial transcript entries with the same client_chunk_id and exact content/source are\ncollapsed in their original order; conflicting payloads for the same ID reject the\nentire request with 409 before creating the note. Entries without an ID retain legacy\nbehavior. A client_chunk_id does not make note creation idempotent.\n","href":"/api-docs/notes/create-a-note"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create a new note","description":"Creates a new note within the specified workspace (team_id).\nThe note object is provided in the request body, including the note title, content,\nand any other relevant details (optional fields include transcript and user notes).\nUpon successful creation, the new note is returned in the response.\nInitial transcript entries with the same client_chunk_id and exact content/source are\ncollapsed in their original order; conflicting payloads for the same ID reject the\nentire request with 409 before creating the note. Entries without an ID retain legacy\nbehavior. A client_chunk_id does not make note creation idempotent.\n","operationId":"createNote","x-ai-agent":true,"x-excluded":true,"tags":["Pages"],"parameters":["11b41786-dddb-4cb4-aac1-2d68a8cbba77"],"requestBody":"2b01fdfe-0005-44c1-a68c-ab7a9fbee0a5","responses":{"200":"ff4d49c0-5572-4518-ac6c-5f4d1189877a","201":"28bf13d0-1310-479d-b56f-4d2d91d58afa","409":"d1be676e-5a77-4bad-a51c-fbaf9139327e","default":"11f8b047-6000-4dc2-802a-5fe0a5c19ea6"},"method":"post","type":"path","servers":["c37be052-6148-4ecf-b35d-32848cca42a7"],"security":["54f21800-c560-43ca-86a6-b1396b396cc5"],"path":"/{team_id}/notes","baseUrlOptions":["https://api.superthread.com/v1"],"title":"Create a new note","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"11b41786-dddb-4cb4-aac1-2d68a8cbba77":{"in":"header","name":"Idempotency-Key","required":false,"description":"Optional id for the new note, so your app can open the note before\nthe request finishes. Retrying with the same key returns the note\nalready created instead of making another. The server generates an\nid when omitted. Must be a lowercase version 7 UUID; any other\nvalue, or the id of an existing or deleted note, is rejected with a\n400.\n","schema":{"type":"string","format":"uuid","isRequired":false,"description":"Optional id for the new note, so your app can open the note before\nthe request finishes. Retrying with the same key returns the note\nalready created instead of making another. The server generates an\nid when omitted. Must be a lowercase version 7 UUID; any other\nvalue, or the id of an existing or deleted note, is rejected with a\n400.\n","uniqueKey":"","typeLabel":"string\u003cuuid>"}},"a87af501-9538-4782-a5d1-486dc11a3966":{"in":"path","name":"team_id","description":"Team ID is an alphanumerical string that identifies a Team. This is externally referred to as a \"Workspace\".","required":true,"schema":{"type":"string","isRequired":true,"description":"Team ID is an alphanumerical string that identifies a Team. This is externally referred to as a \"Workspace\".","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"auto_redact_pii":{"oneOf":[{"type":"boolean","description":"Per-note PII redaction selection. Omission or null preserves unredacted behavior for older clients and defaults to false; supported clients explicitly initialize this from the personal transcription_auto_redact_pii setting.","uniqueKey":"auto_redact_pii.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Per-note PII redaction selection. Omission or null preserves unredacted behavior for older clients and defaults to false; supported clients explicitly initialize this from the personal transcription_auto_redact_pii setting.","uniqueKey":"auto_redact_pii.oneOf.1","typeLabel":"null"}],"uniqueKey":"auto_redact_pii","typeLabel":"boolean | null"},"title":{"type":"string","example":"Team Note","nullable":false,"uniqueKey":"title","typeLabel":"string"},"transcript":{"oneOf":[{"type":"string","uniqueKey":"transcript.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"transcript.oneOf.1","typeLabel":"null"}],"uniqueKey":"transcript","typeLabel":"string | null"},"transcripts":{"type":"array","items":{"type":"object","properties":{"client_chunk_id":{"type":"string","format":"uuid","description":"Optional client-generated chunk identity, retained in the persisted and response transcript.\nPersist the ID, content and source before the first send and reuse that envelope on retries.\nFully keyed transcript-only updates deduplicate exact content/source per note and reject\nmismatched reuse with 409. Omission retains legacy append behavior.\n","uniqueKey":"transcripts.items.[INDEX].client_chunk_id","typeLabel":"string\u003cuuid>"},"content":{"type":"string","example":"This is a transcript","uniqueKey":"transcripts.items.[INDEX].content","typeLabel":"string"},"source":{"type":"string","enum":["author","other"],"uniqueKey":"transcripts.items.[INDEX].source","typeLabel":"enum\u003cstring>"}},"uniqueKey":"transcripts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"transcripts","typeLabel":"object[]"},"user_notes":{"oneOf":[{"type":"string","maxLength":102400,"uniqueKey":"user_notes.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":102400,"uniqueKey":"user_notes.oneOf.1","typeLabel":"null"}],"uniqueKey":"user_notes","typeLabel":"string | null"},"is_public":{"oneOf":[{"type":"boolean","uniqueKey":"is_public.oneOf.0","typeLabel":"boolean"},{"type":"null","uniqueKey":"is_public.oneOf.1","typeLabel":"null"}],"uniqueKey":"is_public","typeLabel":"boolean | null"},"attendees":{"type":"array","description":"List of initial attendees to add.\nAssumes all fields of MeetingParticipant are set (Meaning all participants are Superthread members).\n","maxItems":100,"items":{"oneOf":[{"type":"object","x-omitempty":false,"properties":{"user_id":{"oneOf":[{"type":"string","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false,"uniqueKey":"attendees.items.[INDEX].oneOf.0.user_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false,"uniqueKey":"attendees.items.[INDEX].oneOf.0.user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"attendees.items.[INDEX].oneOf.0.user_id","typeLabel":"string | null"},"email":{"type":"string","example":"username@example.com","description":"Email address of the participant","uniqueKey":"attendees.items.[INDEX].oneOf.0.email","typeLabel":"string"},"name":{"type":"string","example":"John Doe","description":"The display name of the participant","uniqueKey":"attendees.items.[INDEX].oneOf.0.name","typeLabel":"string"}},"uniqueKey":"attendees.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","x-omitempty":false,"properties":{"user_id":{"oneOf":[{"type":"string","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false},{"type":"null","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false}]},"email":{"type":"string","example":"username@example.com","description":"Email address of the participant"},"name":{"type":"string","example":"John Doe","description":"The display name of the participant"}},"uniqueKey":"attendees.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"attendees.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"attendees","typeLabel":"(object | null)[]"},"metadata_date":{"oneOf":[{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"metadata_date.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"metadata_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata_date","typeLabel":"integer\u003cint64> | null"},"metadata_time":{"oneOf":[{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"metadata_time.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"metadata_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata_time","typeLabel":"integer\u003cint64> | null"},"google_calendar_event":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the event.","uniqueKey":"google_calendar_event.id","typeLabel":"string"},"recurring_event_id":{"type":"string","description":"Identifier for the recurring event series.","uniqueKey":"google_calendar_event.recurring_event_id","typeLabel":"string"},"title":{"type":"string","description":"The event's title or name (Summary in Google Calendar).","uniqueKey":"google_calendar_event.title","typeLabel":"string"},"description":{"type":"string","description":"Detailed description of the event.","uniqueKey":"google_calendar_event.description","typeLabel":"string"},"meeting_links":{"type":"array","description":"A list of meeting links with their respective providers.","items":{"type":"object","properties":{"provider":{"type":"string","description":"The provider for the meeting link (e.g., google, zoom, teams, other).","enum":["google","zoom","teams","other"],"uniqueKey":"google_calendar_event.meeting_links.items.[INDEX].provider","typeLabel":"enum\u003cstring>"},"link":{"type":"string","description":"The meeting link.","uniqueKey":"google_calendar_event.meeting_links.items.[INDEX].link","typeLabel":"string"}},"uniqueKey":"google_calendar_event.meeting_links.items.[INDEX]","typeLabel":"object"},"uniqueKey":"google_calendar_event.meeting_links","typeLabel":"object[]"},"attendees":{"type":"array","description":"List of event attendees.","items":{"type":"object","properties":{"email":{"oneOf":[{"type":"string","description":"The email of the attendee.","x-omitempty":false,"uniqueKey":"google_calendar_event.attendees.items.[INDEX].email.oneOf.0","typeLabel":"string"},{"type":"null","description":"The email of the attendee.","x-omitempty":false,"uniqueKey":"google_calendar_event.attendees.items.[INDEX].email.oneOf.1","typeLabel":"null"}],"uniqueKey":"google_calendar_event.attendees.items.[INDEX].email","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","description":"The name of the attendee.","x-omitempty":false,"uniqueKey":"google_calendar_event.attendees.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The name of the attendee.","x-omitempty":false,"uniqueKey":"google_calendar_event.attendees.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"google_calendar_event.attendees.items.[INDEX].name","typeLabel":"string | null"},"organizer":{"oneOf":[{"type":"boolean","description":"Set to true when the attendee is the event organizer.","x-omitempty":false,"uniqueKey":"google_calendar_event.attendees.items.[INDEX].organizer.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Set to true when the attendee is the event organizer.","x-omitempty":false,"uniqueKey":"google_calendar_event.attendees.items.[INDEX].organizer.oneOf.1","typeLabel":"null"}],"uniqueKey":"google_calendar_event.attendees.items.[INDEX].organizer","typeLabel":"boolean | null"}},"uniqueKey":"google_calendar_event.attendees.items.[INDEX]","typeLabel":"object"},"uniqueKey":"google_calendar_event.attendees","typeLabel":"object[]"},"start":{"oneOf":[{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"google_calendar_event.start.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"google_calendar_event.start.oneOf.1","typeLabel":"null"}],"uniqueKey":"google_calendar_event.start","typeLabel":"integer\u003cint64> | null"},"end":{"oneOf":[{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"google_calendar_event.end.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"google_calendar_event.end.oneOf.1","typeLabel":"null"}],"uniqueKey":"google_calendar_event.end","typeLabel":"integer\u003cint64> | null"},"updated":{"oneOf":[{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"google_calendar_event.updated.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"google_calendar_event.updated.oneOf.1","typeLabel":"null"}],"uniqueKey":"google_calendar_event.updated","typeLabel":"integer\u003cint64> | null"},"location":{"type":"string","description":"Free-form text for the event location.","x-omitempty":true,"uniqueKey":"google_calendar_event.location","typeLabel":"string"}},"uniqueKey":"google_calendar_event","typeLabel":"object"},"microsoft_calendar_event":{"type":"object","description":"Normalized meeting data for Notes. IDs must be stable across Microsoft\nsync and updates; consumers qualify them by provider, account and calendar.\nNote create/update must re-fetch the selected event through this user's\ninstallation and persist only the server-verified event, not caller-supplied\nmeeting contents.\n","properties":{"installation_id":{"type":"string","description":"User-scoped Notes installation used to verify this event on note create/update.","uniqueKey":"microsoft_calendar_event.installation_id","typeLabel":"string"},"id":{"type":"string","description":"Immutable provider event ID for this occurrence.","uniqueKey":"microsoft_calendar_event.id","typeLabel":"string"},"recurring_event_id":{"type":"string","description":"Series master ID when this event is an occurrence.","uniqueKey":"microsoft_calendar_event.recurring_event_id","typeLabel":"string"},"provider_account_id":{"type":"string","uniqueKey":"microsoft_calendar_event.provider_account_id","typeLabel":"string"},"provider_tenant_id":{"type":"string","description":"Customer tenant identity for an organizational account.","uniqueKey":"microsoft_calendar_event.provider_tenant_id","typeLabel":"string"},"calendar_id":{"type":"string","uniqueKey":"microsoft_calendar_event.calendar_id","typeLabel":"string"},"title":{"type":"string","uniqueKey":"microsoft_calendar_event.title","typeLabel":"string"},"description":{"type":"string","uniqueKey":"microsoft_calendar_event.description","typeLabel":"string"},"meeting_links":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string","description":"The provider for the meeting link (e.g., google, zoom, teams, other).","enum":["google","zoom","teams","other"],"uniqueKey":"microsoft_calendar_event.meeting_links.items.[INDEX].provider","typeLabel":"enum\u003cstring>"},"link":{"type":"string","description":"The meeting link.","uniqueKey":"microsoft_calendar_event.meeting_links.items.[INDEX].link","typeLabel":"string"}},"uniqueKey":"microsoft_calendar_event.meeting_links.items.[INDEX]","typeLabel":"object"},"uniqueKey":"microsoft_calendar_event.meeting_links","typeLabel":"object[]"},"attendees":{"type":"array","items":{"type":"object","properties":{"email":{"oneOf":[{"type":"string","x-omitempty":false,"uniqueKey":"microsoft_calendar_event.attendees.items.[INDEX].email.oneOf.0","typeLabel":"string"},{"type":"null","x-omitempty":false,"uniqueKey":"microsoft_calendar_event.attendees.items.[INDEX].email.oneOf.1","typeLabel":"null"}],"uniqueKey":"microsoft_calendar_event.attendees.items.[INDEX].email","typeLabel":"string | null"},"name":{"oneOf":[{"type":"string","x-omitempty":false,"uniqueKey":"microsoft_calendar_event.attendees.items.[INDEX].name.oneOf.0","typeLabel":"string"},{"type":"null","x-omitempty":false,"uniqueKey":"microsoft_calendar_event.attendees.items.[INDEX].name.oneOf.1","typeLabel":"null"}],"uniqueKey":"microsoft_calendar_event.attendees.items.[INDEX].name","typeLabel":"string | null"},"organizer":{"oneOf":[{"type":"boolean","x-omitempty":false,"uniqueKey":"microsoft_calendar_event.attendees.items.[INDEX].organizer.oneOf.0","typeLabel":"boolean"},{"type":"null","x-omitempty":false,"uniqueKey":"microsoft_calendar_event.attendees.items.[INDEX].organizer.oneOf.1","typeLabel":"null"}],"uniqueKey":"microsoft_calendar_event.attendees.items.[INDEX].organizer","typeLabel":"boolean | null"}},"uniqueKey":"microsoft_calendar_event.attendees.items.[INDEX]","typeLabel":"object"},"uniqueKey":"microsoft_calendar_event.attendees","typeLabel":"object[]"},"start":{"oneOf":[{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"microsoft_calendar_event.start.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"microsoft_calendar_event.start.oneOf.1","typeLabel":"null"}],"uniqueKey":"microsoft_calendar_event.start","typeLabel":"integer\u003cint64> | null"},"end":{"oneOf":[{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"microsoft_calendar_event.end.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"microsoft_calendar_event.end.oneOf.1","typeLabel":"null"}],"uniqueKey":"microsoft_calendar_event.end","typeLabel":"integer\u003cint64> | null"},"updated":{"oneOf":[{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"microsoft_calendar_event.updated.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"microsoft_calendar_event.updated.oneOf.1","typeLabel":"null"}],"uniqueKey":"microsoft_calendar_event.updated","typeLabel":"integer\u003cint64> | null"},"location":{"type":"string","uniqueKey":"microsoft_calendar_event.location","typeLabel":"string"}},"uniqueKey":"microsoft_calendar_event","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"auto_redact_pii":true,"title":"Team Note","transcript":"\u003cstring>","transcripts":[{"client_chunk_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","content":"This is a transcript"}],"user_notes":"\u003cstring>","is_public":true,"attendees":[{"user_id":"uDsu0j19","email":"username@example.com","name":"John Doe"}],"metadata_date":1608742037016,"metadata_time":1608742037016,"google_calendar_event":{"id":"\u003cstring>","recurring_event_id":"\u003cstring>","title":"\u003cstring>","description":"\u003cstring>","meeting_links":[{"link":"\u003cstring>"}],"attendees":[{"email":"\u003cstring>","name":"\u003cstring>","organizer":true}],"start":1608742037016,"end":1608742037016,"updated":1608742037016,"location":"\u003cstring>"},"microsoft_calendar_event":{"installation_id":"\u003cstring>","id":"\u003cstring>","recurring_event_id":"\u003cstring>","provider_account_id":"\u003cstring>","provider_tenant_id":"\u003cstring>","calendar_id":"\u003cstring>","title":"\u003cstring>","description":"\u003cstring>","meeting_links":[{"link":"\u003cstring>"}],"attendees":[{"email":"\u003cstring>","name":"\u003cstring>","organizer":true}],"start":1608742037016,"end":1608742037016,"updated":1608742037016,"location":"\u003cstring>"}}}},"exampleType":"generated"}},"description":"Note object that needs to be created","required":true,"exampleType":"generated"},"responses":{"ff4d49c0-5572-4518-ac6c-5f4d1189877a":{"description":"The note was already created with this Idempotency-Key and is returned.","content":{"application/json":{"schema":{"type":"object","properties":{"note":{"type":"object","properties":{"auto_redact_pii":{"type":"boolean","x-omitempty":false,"description":"Whether personally identifiable information is redacted during transcription for this note. Existing notes without a stored selection report false.","uniqueKey":"note.auto_redact_pii","typeLabel":"boolean"},"id":{"type":"string","example":"","uniqueKey":"note.id","typeLabel":"string"},"revision":{"type":"integer","format":"int64","minimum":0,"x-omitempty":false,"description":"Whole-note datastore revision. Supply as expected_revision to protect raw and enhanced edits against concurrent changes. Successful mutations return the new revision; pure keyed transcript replay leaves it unchanged. Existing legacy notes without a stored revision report zero.","uniqueKey":"note.revision","typeLabel":"integer\u003cint64>"},"title":{"type":"string","example":"Team Note","uniqueKey":"note.title","typeLabel":"string"},"transcript":{"type":"string","uniqueKey":"note.transcript","typeLabel":"string"},"transcripts":{"type":"array","items":{"type":"object","properties":{"client_chunk_id":{"type":"string","format":"uuid","description":"Optional client-generated chunk identity, retained in the persisted and response transcript.\nPersist the ID, content and source before the first send and reuse that envelope on retries.\nFully keyed transcript-only updates deduplicate exact content/source per note and reject\nmismatched reuse with 409. Omission retains legacy append behavior.\n","uniqueKey":"note.transcripts.items.[INDEX].client_chunk_id","typeLabel":"string\u003cuuid>"},"content":{"type":"string","example":"This is a transcript","uniqueKey":"note.transcripts.items.[INDEX].content","typeLabel":"string"},"source":{"type":"string","enum":["author","other"],"uniqueKey":"note.transcripts.items.[INDEX].source","typeLabel":"enum\u003cstring>"},"id":{"type":"string","example":"43","uniqueKey":"note.transcripts.items.[INDEX].id","typeLabel":"string"},"time_created":{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.transcripts.items.[INDEX].time_created","typeLabel":"integer\u003cint64>"},"time_updated":{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.transcripts.items.[INDEX].time_updated","typeLabel":"integer\u003cint64>"}},"uniqueKey":"note.transcripts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"note.transcripts","typeLabel":"object[]"},"user_notes":{"type":"string","maxLength":102400,"uniqueKey":"note.user_notes","typeLabel":"string"},"ai_notes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"866a3b86-4651-482c-bb69-61921ea4548c","uniqueKey":"note.ai_notes.items.[INDEX].id","typeLabel":"string"},"note_template_id":{"type":"string","example":"1da3b68c-3a82-495c-a6c9-e7a494281a36","uniqueKey":"note.ai_notes.items.[INDEX].note_template_id","typeLabel":"string"},"title":{"type":"string","example":"Team Note","uniqueKey":"note.ai_notes.items.[INDEX].title","typeLabel":"string"},"content":{"type":"string","maxLength":102400,"uniqueKey":"note.ai_notes.items.[INDEX].content","typeLabel":"string"},"time_updated":{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.ai_notes.items.[INDEX].time_updated","typeLabel":"integer\u003cint64>"},"related_resources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"123","uniqueKey":"note.ai_notes.items.[INDEX].related_resources.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["card"],"example":"card","uniqueKey":"note.ai_notes.items.[INDEX].related_resources.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"cosine_similarity":{"type":"number","format":"float64","description":"cosine similarity score","example":0.8,"uniqueKey":"note.ai_notes.items.[INDEX].related_resources.items.[INDEX].cosine_similarity","typeLabel":"number\u003cfloat64>"}},"uniqueKey":"note.ai_notes.items.[INDEX].related_resources.items.[INDEX]","typeLabel":"object"},"uniqueKey":"note.ai_notes.items.[INDEX].related_resources","typeLabel":"object[]"}},"uniqueKey":"note.ai_notes.items.[INDEX]","typeLabel":"object"},"uniqueKey":"note.ai_notes","typeLabel":"object[]"},"user":{"title":"Actor","type":"object","description":"describes a user or robot that created or updated a resource","properties":{"user_id":{"type":"string","example":"uDsu0j19","x-go-custom-tag":"dynamodbav:\",omitempty\"","uniqueKey":"note.user.user_id","typeLabel":"string"},"type":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","example":"user","default":"user","enum":["user","robot","system"],"nullable":false,"uniqueKey":"note.user.type","typeLabel":"enum\u003cstring>"},"source":{"title":"ActorSource","type":"object","description":"describes the source of an actor","properties":{"type":{"type":"string","example":"oauth","enum":["oauth","import","email","agent"],"uniqueKey":"note.user.source.type","typeLabel":"enum\u003cstring>"},"client_id":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"client ID if the resource was created via oauth2 app","example":"oczapier","uniqueKey":"note.user.source.client_id","typeLabel":"string"},"import_id":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"import ID if the resource was created by an import","example":"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197","uniqueKey":"note.user.source.import_id","typeLabel":"string"},"agent_id":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"agent ID if the resource was created by an agent","example":"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197","uniqueKey":"note.user.source.agent_id","typeLabel":"string"},"email_addr":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"email address if the resource was created via an email","example":"somebody@example.com","uniqueKey":"note.user.source.email_addr","typeLabel":"string"},"email_verified":{"type":"boolean","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"whether the email sender was verified","example":false,"uniqueKey":"note.user.source.email_verified","typeLabel":"boolean"},"on_behalf_of":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"User ID of the human responsible for this action. For trigger-initiated agent actions, this is the trigger creator. For mention/chat-initiated actions, this is the user who invoked the agent.","uniqueKey":"note.user.source.on_behalf_of","typeLabel":"string"}},"uniqueKey":"note.user.source","typeLabel":"ActorSource · object"}},"uniqueKey":"note.user","typeLabel":"Actor · object"},"user_updated":{"title":"Actor","type":"object","description":"describes a user or robot that created or updated a resource","properties":{"user_id":{"type":"string","example":"uDsu0j19","x-go-custom-tag":"dynamodbav:\",omitempty\"","uniqueKey":"note.user_updated.user_id","typeLabel":"string"},"type":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","example":"user","default":"user","enum":["user","robot","system"],"nullable":false,"uniqueKey":"note.user_updated.type","typeLabel":"enum\u003cstring>"},"source":{"title":"ActorSource","type":"object","description":"describes the source of an actor","properties":{"type":{"type":"string","example":"oauth","enum":["oauth","import","email","agent"],"uniqueKey":"note.user_updated.source.type","typeLabel":"enum\u003cstring>"},"client_id":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"client ID if the resource was created via oauth2 app","example":"oczapier","uniqueKey":"note.user_updated.source.client_id","typeLabel":"string"},"import_id":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"import ID if the resource was created by an import","example":"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197","uniqueKey":"note.user_updated.source.import_id","typeLabel":"string"},"agent_id":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"agent ID if the resource was created by an agent","example":"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197","uniqueKey":"note.user_updated.source.agent_id","typeLabel":"string"},"email_addr":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"email address if the resource was created via an email","example":"somebody@example.com","uniqueKey":"note.user_updated.source.email_addr","typeLabel":"string"},"email_verified":{"type":"boolean","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"whether the email sender was verified","example":false,"uniqueKey":"note.user_updated.source.email_verified","typeLabel":"boolean"},"on_behalf_of":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"User ID of the human responsible for this action. For trigger-initiated agent actions, this is the trigger creator. For mention/chat-initiated actions, this is the user who invoked the agent.","uniqueKey":"note.user_updated.source.on_behalf_of","typeLabel":"string"}},"uniqueKey":"note.user_updated.source","typeLabel":"ActorSource · object"}},"uniqueKey":"note.user_updated","typeLabel":"Actor · object"},"team_id":{"type":"string","example":"tdsu0j19","uniqueKey":"note.team_id","typeLabel":"string"},"last_note_template_id":{"type":"string","description":"ID of the last note template used for this note","uniqueKey":"note.last_note_template_id","typeLabel":"string"},"is_public":{"type":"boolean","example":false,"x-omitempty":false,"uniqueKey":"note.is_public","typeLabel":"boolean"},"public_settings":{"type":"object","properties":{"url":{"type":"string","example":"https://notes.superthread.com/n/1","uniqueKey":"note.public_settings.url","typeLabel":"string"}},"uniqueKey":"note.public_settings","typeLabel":"object"},"time_created":{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.time_created","typeLabel":"integer\u003cint64>"},"time_updated":{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.time_updated","typeLabel":"integer\u003cint64>"},"meeting_metadata":{"type":"object","properties":{"id":{"type":"string","description":"External ID for the event","uniqueKey":"note.meeting_metadata.id","typeLabel":"string"},"provider":{"type":"string","enum":["google","microsoft"],"description":"Calendar provider; absent on existing Google-linked notes.","uniqueKey":"note.meeting_metadata.provider","typeLabel":"enum\u003cstring>"},"provider_account_id":{"type":"string","description":"Stable account identity; absent on existing Google-linked notes.","uniqueKey":"note.meeting_metadata.provider_account_id","typeLabel":"string"},"provider_tenant_id":{"type":"string","description":"Customer tenant identity when available; absent on existing Google-linked notes.","uniqueKey":"note.meeting_metadata.provider_tenant_id","typeLabel":"string"},"installation_id":{"type":"string","description":"User-scoped Notes installation that supplied the verified event; absent on existing Google-linked notes.","uniqueKey":"note.meeting_metadata.installation_id","typeLabel":"string"},"calendar_id":{"type":"string","description":"Provider calendar identity; absent on existing Google-linked notes.","uniqueKey":"note.meeting_metadata.calendar_id","typeLabel":"string"},"name":{"type":"string","description":"Meeting name or event title","uniqueKey":"note.meeting_metadata.name","typeLabel":"string"},"description":{"type":"string","description":"Meeting description, or event summary","uniqueKey":"note.meeting_metadata.description","typeLabel":"string"},"links":{"type":"array","description":"List of meeting links (with a provider) where users can join the event","items":{"type":"object","properties":{"provider":{"type":"string","description":"The provider for the meeting link (e.g., google, zoom, teams, other).","enum":["google","zoom","teams","other"],"uniqueKey":"note.meeting_metadata.links.items.[INDEX].provider","typeLabel":"enum\u003cstring>"},"link":{"type":"string","description":"The meeting link.","uniqueKey":"note.meeting_metadata.links.items.[INDEX].link","typeLabel":"string"}},"uniqueKey":"note.meeting_metadata.links.items.[INDEX]","typeLabel":"object"},"uniqueKey":"note.meeting_metadata.links","typeLabel":"object[]"},"location":{"type":"string","description":"Location of the event","uniqueKey":"note.meeting_metadata.location","typeLabel":"string"},"start_time":{"oneOf":[{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.meeting_metadata.start_time.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.meeting_metadata.start_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"note.meeting_metadata.start_time","typeLabel":"integer\u003cint64> | null"},"end_time":{"oneOf":[{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.meeting_metadata.end_time.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.meeting_metadata.end_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"note.meeting_metadata.end_time","typeLabel":"integer\u003cint64> | null"}},"uniqueKey":"note.meeting_metadata","typeLabel":"object"},"meeting_date":{"oneOf":[{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.meeting_date.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.meeting_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"note.meeting_date","typeLabel":"integer\u003cint64> | null"},"meeting_time":{"oneOf":[{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.meeting_time.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.meeting_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"note.meeting_time","typeLabel":"integer\u003cint64> | null"},"meeting_organizer":{"oneOf":[{"type":"object","x-omitempty":false,"properties":{"user_id":{"oneOf":[{"type":"string","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false,"uniqueKey":"note.meeting_organizer.oneOf.0.user_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false,"uniqueKey":"note.meeting_organizer.oneOf.0.user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"note.meeting_organizer.oneOf.0.user_id","typeLabel":"string | null"},"email":{"type":"string","example":"username@example.com","description":"Email address of the participant","uniqueKey":"note.meeting_organizer.oneOf.0.email","typeLabel":"string"},"name":{"type":"string","example":"John Doe","description":"The display name of the participant","uniqueKey":"note.meeting_organizer.oneOf.0.name","typeLabel":"string"}},"uniqueKey":"note.meeting_organizer.oneOf.0","typeLabel":"object"},{"type":"null","x-omitempty":false,"properties":{"user_id":{"oneOf":[{"type":"string","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false},{"type":"null","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false}]},"email":{"type":"string","example":"username@example.com","description":"Email address of the participant"},"name":{"type":"string","example":"John Doe","description":"The display name of the participant"}},"uniqueKey":"note.meeting_organizer.oneOf.1","typeLabel":"null"}],"uniqueKey":"note.meeting_organizer","typeLabel":"object | null"},"meeting_attendees":{"oneOf":[{"type":"array","x-omitempty":false,"items":{"oneOf":[{"type":"object","x-omitempty":false,"properties":{"user_id":{"oneOf":[{"type":"string","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false,"uniqueKey":"note.meeting_attendees.oneOf.0.items.[INDEX].oneOf.0.user_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false,"uniqueKey":"note.meeting_attendees.oneOf.0.items.[INDEX].oneOf.0.user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"note.meeting_attendees.oneOf.0.items.[INDEX].oneOf.0.user_id","typeLabel":"string | null"},"email":{"type":"string","example":"username@example.com","description":"Email address of the participant","uniqueKey":"note.meeting_attendees.oneOf.0.items.[INDEX].oneOf.0.email","typeLabel":"string"},"name":{"type":"string","example":"John Doe","description":"The display name of the participant","uniqueKey":"note.meeting_attendees.oneOf.0.items.[INDEX].oneOf.0.name","typeLabel":"string"}},"uniqueKey":"note.meeting_attendees.oneOf.0.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","x-omitempty":false,"properties":{"user_id":{"oneOf":[{"type":"string","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false},{"type":"null","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false}]},"email":{"type":"string","example":"username@example.com","description":"Email address of the participant"},"name":{"type":"string","example":"John Doe","description":"The display name of the participant"}},"uniqueKey":"note.meeting_attendees.oneOf.0.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"note.meeting_attendees.oneOf.0.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"note.meeting_attendees.oneOf.0","typeLabel":"(object | null)[]"},{"type":"null","x-omitempty":false,"items":{"oneOf":[{"type":"object","x-omitempty":false,"properties":{"user_id":{"oneOf":[{"type":"string","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false},{"type":"null","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false}]},"email":{"type":"string","example":"username@example.com","description":"Email address of the participant"},"name":{"type":"string","example":"John Doe","description":"The display name of the participant"}}},{"type":"null","x-omitempty":false,"properties":{"user_id":{"oneOf":[{"type":"string","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false},{"type":"null","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false}]},"email":{"type":"string","example":"username@example.com","description":"Email address of the participant"},"name":{"type":"string","example":"John Doe","description":"The display name of the participant"}}}]},"uniqueKey":"note.meeting_attendees.oneOf.1","typeLabel":"null"}],"uniqueKey":"note.meeting_attendees","typeLabel":"(object | null)[] | null"}},"uniqueKey":"note","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"note":{"auto_redact_pii":true,"id":"","revision":1,"title":"Team Note","transcript":"\u003cstring>","transcripts":[{"client_chunk_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","content":"This is a transcript","source":"author","id":"43","time_created":1608742037016,"time_updated":1608742037016}],"user_notes":"\u003cstring>","ai_notes":[{"id":"866a3b86-4651-482c-bb69-61921ea4548c","note_template_id":"1da3b68c-3a82-495c-a6c9-e7a494281a36","title":"Team Note","content":"\u003cstring>","time_updated":1608742037016,"related_resources":[{"id":"123","type":"card","cosine_similarity":0.8}]}],"user":{"user_id":"uDsu0j19","type":"user","source":{"type":"oauth","client_id":"oczapier","import_id":"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197","agent_id":"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197","email_addr":"somebody@example.com","email_verified":false,"on_behalf_of":"\u003cstring>"}},"user_updated":{"user_id":"uDsu0j19","type":"user","source":{"type":"oauth","client_id":"oczapier","import_id":"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197","agent_id":"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197","email_addr":"somebody@example.com","email_verified":false,"on_behalf_of":"\u003cstring>"}},"team_id":"tdsu0j19","last_note_template_id":"\u003cstring>","is_public":false,"public_settings":{"url":"https://notes.superthread.com/n/1"},"time_created":1608742037016,"time_updated":1608742037016,"meeting_metadata":{"id":"\u003cstring>","provider":"google","provider_account_id":"\u003cstring>","provider_tenant_id":"\u003cstring>","installation_id":"\u003cstring>","calendar_id":"\u003cstring>","name":"\u003cstring>","description":"\u003cstring>","links":[{"provider":"google","link":"\u003cstring>"}],"location":"\u003cstring>","start_time":1608742037016,"end_time":1608742037016},"meeting_date":1608742037016,"meeting_time":1608742037016,"meeting_organizer":{"user_id":"uDsu0j19","email":"username@example.com","name":"John Doe"},"meeting_attendees":[{"user_id":"uDsu0j19","email":"username@example.com","name":"John Doe"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"28bf13d0-1310-479d-b56f-4d2d91d58afa":{"description":"note created","content":{"application/json":{"schema":{"type":"object","properties":{"note":{"type":"object","properties":{"auto_redact_pii":{"type":"boolean","x-omitempty":false,"description":"Whether personally identifiable information is redacted during transcription for this note. Existing notes without a stored selection report false.","uniqueKey":"note.auto_redact_pii","typeLabel":"boolean"},"id":{"type":"string","example":"","uniqueKey":"note.id","typeLabel":"string"},"revision":{"type":"integer","format":"int64","minimum":0,"x-omitempty":false,"description":"Whole-note datastore revision. Supply as expected_revision to protect raw and enhanced edits against concurrent changes. Successful mutations return the new revision; pure keyed transcript replay leaves it unchanged. Existing legacy notes without a stored revision report zero.","uniqueKey":"note.revision","typeLabel":"integer\u003cint64>"},"title":{"type":"string","example":"Team Note","uniqueKey":"note.title","typeLabel":"string"},"transcript":{"type":"string","uniqueKey":"note.transcript","typeLabel":"string"},"transcripts":{"type":"array","items":{"type":"object","properties":{"client_chunk_id":{"type":"string","format":"uuid","description":"Optional client-generated chunk identity, retained in the persisted and response transcript.\nPersist the ID, content and source before the first send and reuse that envelope on retries.\nFully keyed transcript-only updates deduplicate exact content/source per note and reject\nmismatched reuse with 409. Omission retains legacy append behavior.\n","uniqueKey":"note.transcripts.items.[INDEX].client_chunk_id","typeLabel":"string\u003cuuid>"},"content":{"type":"string","example":"This is a transcript","uniqueKey":"note.transcripts.items.[INDEX].content","typeLabel":"string"},"source":{"type":"string","enum":["author","other"],"uniqueKey":"note.transcripts.items.[INDEX].source","typeLabel":"enum\u003cstring>"},"id":{"type":"string","example":"43","uniqueKey":"note.transcripts.items.[INDEX].id","typeLabel":"string"},"time_created":{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.transcripts.items.[INDEX].time_created","typeLabel":"integer\u003cint64>"},"time_updated":{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.transcripts.items.[INDEX].time_updated","typeLabel":"integer\u003cint64>"}},"uniqueKey":"note.transcripts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"note.transcripts","typeLabel":"object[]"},"user_notes":{"type":"string","maxLength":102400,"uniqueKey":"note.user_notes","typeLabel":"string"},"ai_notes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"866a3b86-4651-482c-bb69-61921ea4548c","uniqueKey":"note.ai_notes.items.[INDEX].id","typeLabel":"string"},"note_template_id":{"type":"string","example":"1da3b68c-3a82-495c-a6c9-e7a494281a36","uniqueKey":"note.ai_notes.items.[INDEX].note_template_id","typeLabel":"string"},"title":{"type":"string","example":"Team Note","uniqueKey":"note.ai_notes.items.[INDEX].title","typeLabel":"string"},"content":{"type":"string","maxLength":102400,"uniqueKey":"note.ai_notes.items.[INDEX].content","typeLabel":"string"},"time_updated":{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.ai_notes.items.[INDEX].time_updated","typeLabel":"integer\u003cint64>"},"related_resources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"123","uniqueKey":"note.ai_notes.items.[INDEX].related_resources.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["card"],"example":"card","uniqueKey":"note.ai_notes.items.[INDEX].related_resources.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"cosine_similarity":{"type":"number","format":"float64","description":"cosine similarity score","example":0.8,"uniqueKey":"note.ai_notes.items.[INDEX].related_resources.items.[INDEX].cosine_similarity","typeLabel":"number\u003cfloat64>"}},"uniqueKey":"note.ai_notes.items.[INDEX].related_resources.items.[INDEX]","typeLabel":"object"},"uniqueKey":"note.ai_notes.items.[INDEX].related_resources","typeLabel":"object[]"}},"uniqueKey":"note.ai_notes.items.[INDEX]","typeLabel":"object"},"uniqueKey":"note.ai_notes","typeLabel":"object[]"},"user":{"title":"Actor","type":"object","description":"describes a user or robot that created or updated a resource","properties":{"user_id":{"type":"string","example":"uDsu0j19","x-go-custom-tag":"dynamodbav:\",omitempty\"","uniqueKey":"note.user.user_id","typeLabel":"string"},"type":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","example":"user","default":"user","enum":["user","robot","system"],"nullable":false,"uniqueKey":"note.user.type","typeLabel":"enum\u003cstring>"},"source":{"title":"ActorSource","type":"object","description":"describes the source of an actor","properties":{"type":{"type":"string","example":"oauth","enum":["oauth","import","email","agent"],"uniqueKey":"note.user.source.type","typeLabel":"enum\u003cstring>"},"client_id":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"client ID if the resource was created via oauth2 app","example":"oczapier","uniqueKey":"note.user.source.client_id","typeLabel":"string"},"import_id":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"import ID if the resource was created by an import","example":"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197","uniqueKey":"note.user.source.import_id","typeLabel":"string"},"agent_id":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"agent ID if the resource was created by an agent","example":"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197","uniqueKey":"note.user.source.agent_id","typeLabel":"string"},"email_addr":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"email address if the resource was created via an email","example":"somebody@example.com","uniqueKey":"note.user.source.email_addr","typeLabel":"string"},"email_verified":{"type":"boolean","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"whether the email sender was verified","example":false,"uniqueKey":"note.user.source.email_verified","typeLabel":"boolean"},"on_behalf_of":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"User ID of the human responsible for this action. For trigger-initiated agent actions, this is the trigger creator. For mention/chat-initiated actions, this is the user who invoked the agent.","uniqueKey":"note.user.source.on_behalf_of","typeLabel":"string"}},"uniqueKey":"note.user.source","typeLabel":"ActorSource · object"}},"uniqueKey":"note.user","typeLabel":"Actor · object"},"user_updated":{"title":"Actor","type":"object","description":"describes a user or robot that created or updated a resource","properties":{"user_id":{"type":"string","example":"uDsu0j19","x-go-custom-tag":"dynamodbav:\",omitempty\"","uniqueKey":"note.user_updated.user_id","typeLabel":"string"},"type":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","example":"user","default":"user","enum":["user","robot","system"],"nullable":false,"uniqueKey":"note.user_updated.type","typeLabel":"enum\u003cstring>"},"source":{"title":"ActorSource","type":"object","description":"describes the source of an actor","properties":{"type":{"type":"string","example":"oauth","enum":["oauth","import","email","agent"],"uniqueKey":"note.user_updated.source.type","typeLabel":"enum\u003cstring>"},"client_id":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"client ID if the resource was created via oauth2 app","example":"oczapier","uniqueKey":"note.user_updated.source.client_id","typeLabel":"string"},"import_id":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"import ID if the resource was created by an import","example":"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197","uniqueKey":"note.user_updated.source.import_id","typeLabel":"string"},"agent_id":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"agent ID if the resource was created by an agent","example":"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197","uniqueKey":"note.user_updated.source.agent_id","typeLabel":"string"},"email_addr":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"email address if the resource was created via an email","example":"somebody@example.com","uniqueKey":"note.user_updated.source.email_addr","typeLabel":"string"},"email_verified":{"type":"boolean","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"whether the email sender was verified","example":false,"uniqueKey":"note.user_updated.source.email_verified","typeLabel":"boolean"},"on_behalf_of":{"type":"string","x-go-custom-tag":"dynamodbav:\",omitempty\"","description":"User ID of the human responsible for this action. For trigger-initiated agent actions, this is the trigger creator. For mention/chat-initiated actions, this is the user who invoked the agent.","uniqueKey":"note.user_updated.source.on_behalf_of","typeLabel":"string"}},"uniqueKey":"note.user_updated.source","typeLabel":"ActorSource · object"}},"uniqueKey":"note.user_updated","typeLabel":"Actor · object"},"team_id":{"type":"string","example":"tdsu0j19","uniqueKey":"note.team_id","typeLabel":"string"},"last_note_template_id":{"type":"string","description":"ID of the last note template used for this note","uniqueKey":"note.last_note_template_id","typeLabel":"string"},"is_public":{"type":"boolean","example":false,"x-omitempty":false,"uniqueKey":"note.is_public","typeLabel":"boolean"},"public_settings":{"type":"object","properties":{"url":{"type":"string","example":"https://notes.superthread.com/n/1","uniqueKey":"note.public_settings.url","typeLabel":"string"}},"uniqueKey":"note.public_settings","typeLabel":"object"},"time_created":{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.time_created","typeLabel":"integer\u003cint64>"},"time_updated":{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.time_updated","typeLabel":"integer\u003cint64>"},"meeting_metadata":{"type":"object","properties":{"id":{"type":"string","description":"External ID for the event","uniqueKey":"note.meeting_metadata.id","typeLabel":"string"},"provider":{"type":"string","enum":["google","microsoft"],"description":"Calendar provider; absent on existing Google-linked notes.","uniqueKey":"note.meeting_metadata.provider","typeLabel":"enum\u003cstring>"},"provider_account_id":{"type":"string","description":"Stable account identity; absent on existing Google-linked notes.","uniqueKey":"note.meeting_metadata.provider_account_id","typeLabel":"string"},"provider_tenant_id":{"type":"string","description":"Customer tenant identity when available; absent on existing Google-linked notes.","uniqueKey":"note.meeting_metadata.provider_tenant_id","typeLabel":"string"},"installation_id":{"type":"string","description":"User-scoped Notes installation that supplied the verified event; absent on existing Google-linked notes.","uniqueKey":"note.meeting_metadata.installation_id","typeLabel":"string"},"calendar_id":{"type":"string","description":"Provider calendar identity; absent on existing Google-linked notes.","uniqueKey":"note.meeting_metadata.calendar_id","typeLabel":"string"},"name":{"type":"string","description":"Meeting name or event title","uniqueKey":"note.meeting_metadata.name","typeLabel":"string"},"description":{"type":"string","description":"Meeting description, or event summary","uniqueKey":"note.meeting_metadata.description","typeLabel":"string"},"links":{"type":"array","description":"List of meeting links (with a provider) where users can join the event","items":{"type":"object","properties":{"provider":{"type":"string","description":"The provider for the meeting link (e.g., google, zoom, teams, other).","enum":["google","zoom","teams","other"],"uniqueKey":"note.meeting_metadata.links.items.[INDEX].provider","typeLabel":"enum\u003cstring>"},"link":{"type":"string","description":"The meeting link.","uniqueKey":"note.meeting_metadata.links.items.[INDEX].link","typeLabel":"string"}},"uniqueKey":"note.meeting_metadata.links.items.[INDEX]","typeLabel":"object"},"uniqueKey":"note.meeting_metadata.links","typeLabel":"object[]"},"location":{"type":"string","description":"Location of the event","uniqueKey":"note.meeting_metadata.location","typeLabel":"string"},"start_time":{"oneOf":[{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.meeting_metadata.start_time.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.meeting_metadata.start_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"note.meeting_metadata.start_time","typeLabel":"integer\u003cint64> | null"},"end_time":{"oneOf":[{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.meeting_metadata.end_time.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.meeting_metadata.end_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"note.meeting_metadata.end_time","typeLabel":"integer\u003cint64> | null"}},"uniqueKey":"note.meeting_metadata","typeLabel":"object"},"meeting_date":{"oneOf":[{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.meeting_date.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.meeting_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"note.meeting_date","typeLabel":"integer\u003cint64> | null"},"meeting_time":{"oneOf":[{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.meeting_time.oneOf.0","typeLabel":"integer\u003cint64>"},{"type":"null","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"note.meeting_time.oneOf.1","typeLabel":"null"}],"uniqueKey":"note.meeting_time","typeLabel":"integer\u003cint64> | null"},"meeting_organizer":{"oneOf":[{"type":"object","x-omitempty":false,"properties":{"user_id":{"oneOf":[{"type":"string","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false,"uniqueKey":"note.meeting_organizer.oneOf.0.user_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false,"uniqueKey":"note.meeting_organizer.oneOf.0.user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"note.meeting_organizer.oneOf.0.user_id","typeLabel":"string | null"},"email":{"type":"string","example":"username@example.com","description":"Email address of the participant","uniqueKey":"note.meeting_organizer.oneOf.0.email","typeLabel":"string"},"name":{"type":"string","example":"John Doe","description":"The display name of the participant","uniqueKey":"note.meeting_organizer.oneOf.0.name","typeLabel":"string"}},"uniqueKey":"note.meeting_organizer.oneOf.0","typeLabel":"object"},{"type":"null","x-omitempty":false,"properties":{"user_id":{"oneOf":[{"type":"string","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false},{"type":"null","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false}]},"email":{"type":"string","example":"username@example.com","description":"Email address of the participant"},"name":{"type":"string","example":"John Doe","description":"The display name of the participant"}},"uniqueKey":"note.meeting_organizer.oneOf.1","typeLabel":"null"}],"uniqueKey":"note.meeting_organizer","typeLabel":"object | null"},"meeting_attendees":{"oneOf":[{"type":"array","x-omitempty":false,"items":{"oneOf":[{"type":"object","x-omitempty":false,"properties":{"user_id":{"oneOf":[{"type":"string","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false,"uniqueKey":"note.meeting_attendees.oneOf.0.items.[INDEX].oneOf.0.user_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false,"uniqueKey":"note.meeting_attendees.oneOf.0.items.[INDEX].oneOf.0.user_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"note.meeting_attendees.oneOf.0.items.[INDEX].oneOf.0.user_id","typeLabel":"string | null"},"email":{"type":"string","example":"username@example.com","description":"Email address of the participant","uniqueKey":"note.meeting_attendees.oneOf.0.items.[INDEX].oneOf.0.email","typeLabel":"string"},"name":{"type":"string","example":"John Doe","description":"The display name of the participant","uniqueKey":"note.meeting_attendees.oneOf.0.items.[INDEX].oneOf.0.name","typeLabel":"string"}},"uniqueKey":"note.meeting_attendees.oneOf.0.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","x-omitempty":false,"properties":{"user_id":{"oneOf":[{"type":"string","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false},{"type":"null","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false}]},"email":{"type":"string","example":"username@example.com","description":"Email address of the participant"},"name":{"type":"string","example":"John Doe","description":"The display name of the participant"}},"uniqueKey":"note.meeting_attendees.oneOf.0.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"note.meeting_attendees.oneOf.0.items.[INDEX]","typeLabel":"object | null"},"uniqueKey":"note.meeting_attendees.oneOf.0","typeLabel":"(object | null)[]"},{"type":"null","x-omitempty":false,"items":{"oneOf":[{"type":"object","x-omitempty":false,"properties":{"user_id":{"oneOf":[{"type":"string","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false},{"type":"null","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false}]},"email":{"type":"string","example":"username@example.com","description":"Email address of the participant"},"name":{"type":"string","example":"John Doe","description":"The display name of the participant"}}},{"type":"null","x-omitempty":false,"properties":{"user_id":{"oneOf":[{"type":"string","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false},{"type":"null","description":"Internal User ID if the email of the meeting attendee belongs to a Superthread user in the workspace.","example":"uDsu0j19","x-omitempty":false}]},"email":{"type":"string","example":"username@example.com","description":"Email address of the participant"},"name":{"type":"string","example":"John Doe","description":"The display name of the participant"}}}]},"uniqueKey":"note.meeting_attendees.oneOf.1","typeLabel":"null"}],"uniqueKey":"note.meeting_attendees","typeLabel":"(object | null)[] | null"}},"uniqueKey":"note","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"note":{"auto_redact_pii":true,"id":"","revision":1,"title":"Team Note","transcript":"\u003cstring>","transcripts":[{"client_chunk_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","content":"This is a transcript","source":"author","id":"43","time_created":1608742037016,"time_updated":1608742037016}],"user_notes":"\u003cstring>","ai_notes":[{"id":"866a3b86-4651-482c-bb69-61921ea4548c","note_template_id":"1da3b68c-3a82-495c-a6c9-e7a494281a36","title":"Team Note","content":"\u003cstring>","time_updated":1608742037016,"related_resources":[{"id":"123","type":"card","cosine_similarity":0.8}]}],"user":{"user_id":"uDsu0j19","type":"user","source":{"type":"oauth","client_id":"oczapier","import_id":"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197","agent_id":"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197","email_addr":"somebody@example.com","email_verified":false,"on_behalf_of":"\u003cstring>"}},"user_updated":{"user_id":"uDsu0j19","type":"user","source":{"type":"oauth","client_id":"oczapier","import_id":"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197","agent_id":"bf1b9f76-3f95-42fc-bd7f-050b2f5f4197","email_addr":"somebody@example.com","email_verified":false,"on_behalf_of":"\u003cstring>"}},"team_id":"tdsu0j19","last_note_template_id":"\u003cstring>","is_public":false,"public_settings":{"url":"https://notes.superthread.com/n/1"},"time_created":1608742037016,"time_updated":1608742037016,"meeting_metadata":{"id":"\u003cstring>","provider":"google","provider_account_id":"\u003cstring>","provider_tenant_id":"\u003cstring>","installation_id":"\u003cstring>","calendar_id":"\u003cstring>","name":"\u003cstring>","description":"\u003cstring>","links":[{"provider":"google","link":"\u003cstring>"}],"location":"\u003cstring>","start_time":1608742037016,"end_time":1608742037016},"meeting_date":1608742037016,"meeting_time":1608742037016,"meeting_organizer":{"user_id":"uDsu0j19","email":"username@example.com","name":"John Doe"},"meeting_attendees":[{"user_id":"uDsu0j19","email":"username@example.com","name":"John Doe"}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"d1be676e-5a77-4bad-a51c-fbaf9139327e":{"description":"A client_chunk_id was repeated with different content or source; no note was created.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"id":{"type":"string","example":"err5f744ab","uniqueKey":"error.id","typeLabel":"string"},"code":{"type":"integer","format":"int32","example":403,"uniqueKey":"error.code","typeLabel":"integer\u003cint32>"},"sec":{"type":"string","description":"Superthread Error Code (`SEC`): A structured error code.\nFormat: `SEC:{ServiceID}-{InternalErrorCode}`.\n\n\n - `SEC`: Prefix for all structured error codes.\n - `ServiceID`: First 3 characters identify the service, '000' is reserved for generic errors.\n - `InternalErrorCode`: the next (last) 5 characters define the specific error.\n","pattern":"^SEC:\\d{3}-\\d{5}$","example":"SEC:000-00014","uniqueKey":"error.sec","typeLabel":"string"},"message":{"type":"string","example":"You do not have access to this resource","description":"A user-friendly error message","uniqueKey":"error.message","typeLabel":"string"},"date":{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"error.date","typeLabel":"integer\u003cint64>"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"id":"err5f744ab","code":403,"sec":"SEC:000-00014","message":"You do not have access to this resource","date":1608742037016}}}},"exampleType":"generated"}},"exampleType":"generated"},"11f8b047-6000-4dc2-802a-5fe0a5c19ea6":{"description":"client error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"id":{"type":"string","example":"err5f744ab","uniqueKey":"error.id","typeLabel":"string"},"code":{"type":"integer","format":"int32","example":403,"uniqueKey":"error.code","typeLabel":"integer\u003cint32>"},"sec":{"type":"string","description":"Superthread Error Code (`SEC`): A structured error code.\nFormat: `SEC:{ServiceID}-{InternalErrorCode}`.\n\n\n - `SEC`: Prefix for all structured error codes.\n - `ServiceID`: First 3 characters identify the service, '000' is reserved for generic errors.\n - `InternalErrorCode`: the next (last) 5 characters define the specific error.\n","pattern":"^SEC:\\d{3}-\\d{5}$","example":"SEC:000-00014","uniqueKey":"error.sec","typeLabel":"string"},"message":{"type":"string","example":"You do not have access to this resource","description":"A user-friendly error message","uniqueKey":"error.message","typeLabel":"string"},"date":{"type":"integer","format":"int64","example":1608742037016,"description":"unix timestamp in seconds","x-go-type":{"type":"STime","import":{"package":"github.com/superthread-com/common/pkg/types"},"hints":{"noValidation":true,"kind":"primitive"}},"uniqueKey":"error.date","typeLabel":"integer\u003cint64>"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"id":"err5f744ab","code":403,"sec":"SEC:000-00014","message":"You do not have access to this resource","date":1608742037016}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"54f21800-c560-43ca-86a6-b1396b396cc5":{"BearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"c37be052-6148-4ecf-b35d-32848cca42a7":{"url":"https://api.superthread.com/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"superthread.yaml"},"subdomain":"superthread","siteName":"Superthread help center","title":"Create a note - Superthread help center","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-12T16:05:21.984Z","originalFileLocation":"api-docs/notes/create-a-note.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Creates a new note within the specified workspace (team_id). The note object is provided in the request body, including the note title, content, and any other relevant details (optional fields include transcript and user notes). Upon successful creation, the new note is returned in the response. Initial transcript entries with the same client_chunk_id and exact content/source are collapsed in their original order; conflicting payloads for the same ID reject the entire request with 409 before creating the note. Entries without an ID retain legacy behavior. A client_chunk_id does not make note creation idempotent.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Superthread help center\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/superthread/yMxqwTj4LNjxeDTn/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/superthread/yMxqwTj4LNjxeDTn/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/superthread/yMxqwTj4LNjxeDTn/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/superthread/yMxqwTj4LNjxeDTn/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/superthread/yMxqwTj4LNjxeDTn/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/superthread/yMxqwTj4LNjxeDTn/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/superthread/yMxqwTj4LNjxeDTn/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/superthread/yMxqwTj4LNjxeDTn/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/superthread/yMxqwTj4LNjxeDTn/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a note - Superthread help center\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a new note within the specified workspace (team_id). The note object is provided in the request body, including the note title, content, and any other relevant details (optional fields include transcript and user notes). Upon successful creation, the new note is returned in the response. Initial transcript entries with the same client_chunk_id and exact content/source are collapsed in their original order; conflicting payloads for the same ID reject the entire request with 409 before creating the note. Entries without an ID retain legacy behavior. A client_chunk_id does not make note creation idempotent.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Superthread help center\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://superthread.com/docs/api-docs/notes/create-a-note\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://superthread.mintlify.app/_mintlify/api/og/v2?division=Notes\u0026amp;title=Create+a+note\u0026amp;description=Creates+a+new+note+within+the+specified+workspace+%28team_id%29.%0AThe+note+object+is+provided+in+the+request+body%2C+including+the+note+title%2C+content%2C%0Aand+any+other+r\u0026amp;theme=12ef36890fcbcd2fc595f246\u0026amp;signature=fa1db4338e7215a02589101b12b7cafc86cb2e30d946f16558e0c4cc9e4c5ec6\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a note - Superthread help center\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a new note within the specified workspace (team_id). The note object is provided in the request body, including the note title, content, and any other relevant details (optional fields include transcript and user notes). Upon successful creation, the new note is returned in the response. Initial transcript entries with the same client_chunk_id and exact content/source are collapsed in their original order; conflicting payloads for the same ID reject the entire request with 409 before creating the note. Entries without an ID retain legacy behavior. A client_chunk_id does not make note creation idempotent.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://superthread.mintlify.app/_mintlify/api/og/v2?division=Notes\u0026amp;title=Create+a+note\u0026amp;description=Creates+a+new+note+within+the+specified+workspace+%28team_id%29.%0AThe+note+object+is+provided+in+the+request+body%2C+including+the+note+title%2C+content%2C%0Aand+any+other+r\u0026amp;theme=12ef36890fcbcd2fc595f246\u0026amp;signature=fa1db4338e7215a02589101b12b7cafc86cb2e30d946f16558e0c4cc9e4c5ec6\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/superthread/yMxqwTj4LNjxeDTn/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Superthread help center\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://superthread.com/docs/api-docs/notes/create-a-note\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-docs/notes/create-a-note.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://superthread.com/#organization\",\"name\":\"Superthread help center\",\"url\":\"https://superthread.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/superthread/8Pe5qUtfxBYjsAW7/logo/light.svg?fit=max\u0026auto=format\u0026n=8Pe5qUtfxBYjsAW7\u0026q=85\u0026s=3ec799023892643fb9a9173e31d2cbc2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://superthread.com/docs#website\",\"name\":\"Superthread help center\",\"url\":\"https://superthread.com/docs\",\"publisher\":{\"@id\":\"https://superthread.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://superthread.com/docs/api-docs/notes/create-a-note#webpage\",\"url\":\"https://superthread.com/docs/api-docs/notes/create-a-note\",\"name\":\"Create a note\",\"description\":\"Creates a new note within the specified workspace (team_id). The note object is provided in the request body, including the note title, content, and any other relevant details (optional fields include transcript and user notes). Upon successful creation, the new note is returned in the response. Initial transcript entries with the same client_chunk_id and exact content/source are collapsed in their original order; conflicting payloads for the same ID reject the entire request with 409 before creating the note. Entries without an ID retain legacy behavior. A client_chunk_id does not make note creation idempotent.\",\"dateModified\":\"2026-10-12T16:05:21.984Z\",\"isPartOf\":{\"@id\":\"https://superthread.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://superthread.com/docs/api-docs/notes/create-a-note#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://superthread.com/docs/api-docs/notes/create-a-note#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Superthread help center\",\"item\":\"https://superthread.com/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a note\",\"item\":\"https://superthread.com/docs/api-docs/notes/create-a-note\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://superthread.com/docs/api-docs/notes/create-a-note#apireference\",\"headline\":\"Create a note\",\"name\":\"Create a note\",\"description\":\"Creates a new note within the specified workspace (team_id). The note object is provided in the request body, including the note title, content, and any other relevant details (optional fields include transcript and user notes). Upon successful creation, the new note is returned in the response. Initial transcript entries with the same client_chunk_id and exact content/source are collapsed in their original order; conflicting payloads for the same ID reject the entire request with 409 before creating the note. Entries without an ID retain legacy behavior. A client_chunk_id does not make note creation idempotent.\",\"url\":\"https://superthread.com/docs/api-docs/notes/create-a-note\",\"mainEntityOfPage\":{\"@id\":\"https://superthread.com/docs/api-docs/notes/create-a-note#webpage\"},\"dateModified\":\"2026-10-12T16:05:21.984Z\",\"publisher\":{\"@id\":\"https://superthread.com/#organization\"},\"isPartOf\":{\"@id\":\"https://superthread.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Superthread help center\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Superthread help center","nav":{"global":{},"tabs":[{"tab":"Help","pages":[{"title":"Help","href":""}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"API docs","groups":[{"group":"Get started","pages":[{"title":"Authentication","href":"/api-docs/auth"},{"title":"API terminology","href":"/api-docs/api-terminology"}]},{"group":"Users","pages":[{"title":"Get my account","openapi":"GET /users/{user_id}","href":"/api-docs/users/get-my-account"},{"title":"Update my account","openapi":"PATCH /users/{user_id}","href":"/api-docs/users/update-my-account"},{"title":"Get team members","openapi":"GET /teams/{team_id}/members","href":"/api-docs/users/get-team-members"},{"title":"Update a team member","openapi":"PATCH /teams/{team_id}/members/{user_id}","href":"/api-docs/users/update-a-team-member"},{"title":"Delete a team member","openapi":"DELETE /teams/{team_id}/members/{user_id}","href":"/api-docs/users/delete-a-team-member"}]},{"group":"Cards","pages":[{"title":"Create a card","openapi":"POST /{team_id}/cards","href":"/api-docs/cards/create-a-card"},{"title":"Update a card property","openapi":"PATCH /{team_id}/cards/{card_id}","href":"/api-docs/cards/update-a-card"},{"title":"Replace a card description","openapi":"PUT /{team_id}/cards/{card_id}/content","href":"/api-docs/cards/replace-a-card-description"},{"title":"Get tags","openapi":"GET /{team_id}/tags","href":"/api-docs/cards/get-tags"},{"title":"Add tags to a card","openapi":"POST /{team_id}/cards/{card_id}/tags","href":"/api-docs/cards/add-tags"},{"title":"Remove a tag from a card","openapi":"DELETE /{team_id}/cards/{card_id}/tags/{tag_id}","href":"/api-docs/cards/remove-a-tag"},{"title":"Get a card","openapi":"GET /{team_id}/cards/{card_id}","href":"/api-docs/cards/get-a-card"},{"title":"Get card activity","openapi":"GET /{team_id}/activity","href":"/api-docs/cards/get-card-activity"},{"title":"Duplicate a card","openapi":"POST /{team_id}/cards/{card_id}/copy","href":"/api-docs/cards/duplicate-a-card"},{"title":"Get cards assigned to a user","openapi":"POST /{team_id}/views/preview","href":"/api-docs/cards/get-cards"},{"title":"Add related card","openapi":"POST /{team_id}/cards/{card_id}/linked_cards","href":"/api-docs/cards/add-related-card"},{"title":"Remove related card","openapi":"DELETE /{team_id}/cards/{card_id}/linked_cards/{linked_card_id}","href":"/api-docs/cards/remove-related-card"},{"title":"Archive a card","openapi":"PATCH /{team_id}/cards/{card_id}","href":"/api-docs/cards/archive-a-card"},{"title":"Delete a card","openapi":"DELETE /{team_id}/cards/{card_id}","href":"/api-docs/cards/delete-a-card"}]},{"group":"Projects","pages":[{"title":"Create a project","openapi":"POST /{team_id}/epics","href":"/api-docs/projects/create-a-project"},{"title":"Update a project","openapi":"PATCH /{team_id}/epics/{epic_id}","href":"/api-docs/projects/update-a-project"},{"title":"Replace a project description","openapi":"PUT /{team_id}/epics/{epic_id}/content","href":"/api-docs/projects/replace-a-project-description"},{"title":"Get a project","openapi":"GET /{team_id}/epics/{epic_id}","href":"/api-docs/projects/get-a-project"},{"title":"Get project activity","openapi":"GET /{team_id}/activity","href":"/api-docs/projects/get-project-activity"},{"title":"Get projects","openapi":"GET /{team_id}/epics","href":"/api-docs/projects/get-projects"},{"title":"Add related project","openapi":"POST /{team_id}/cards/{card_id}/linked_cards","href":"/api-docs/projects/add-related-project"},{"title":"Remove related project","openapi":"DELETE /{team_id}/cards/{card_id}/linked_cards/{linked_card_id}","href":"/api-docs/projects/remove-related-project"},{"title":"Archive a project","openapi":"PATCH /{team_id}/epics/{epic_id}","href":"/api-docs/projects/archive-a-project"},{"title":"Delete a project","openapi":"DELETE /{team_id}/epics/{epic_id}","description":"Delete an epic (project) in a workspace (`team_id`).\nThis operation removes the project but cards associated with the epic remain intact.\n","href":"/api-docs/projects/delete-a-project"}]},{"group":"Notes","pages":[{"title":"Create a note","openapi":"POST /{team_id}/notes","href":"/api-docs/notes/create-a-note"},{"title":"Get a note","openapi":"GET /{team_id}/notes/{note_id}","description":"Retrieves a specific note within the specified workspace (`team_id`).\nThe note is identified by the provided note_id and returned in the response.\n","href":"/api-docs/notes/get-a-note"},{"title":"Get notes","openapi":"GET /{team_id}/notes","href":"/api-docs/notes/get-notes"},{"title":"Delete a note","openapi":"DELETE /{team_id}/notes/{note_id}","href":"/api-docs/notes/delete-a-note"},{"title":"Enhance or revise a note","openapi":"POST /{team_id}/notes/{note_id}/enhancement","href":"/api-docs/notes/enhance-a-note"},{"title":"Observe a note enhancement","openapi":"GET /{team_id}/notes/{note_id}/enhancement","href":"/api-docs/notes/get-note-enhancement"},{"title":"Update an enhanced note","openapi":"PATCH /{team_id}/notes/{note_id}/enhanced/{enhanced_note_id}","href":"/api-docs/notes/update-enhanced-note"},{"title":"List note templates","openapi":"GET /{team_id}/notes/templates","href":"/api-docs/notes/get-note-templates"},{"title":"Get a note template","openapi":"GET /{team_id}/notes/templates/{template_id}","href":"/api-docs/notes/get-note-template"},{"title":"Update a note template","openapi":"PATCH /{team_id}/notes/templates/{template_id}","href":"/api-docs/notes/update-note-template"}]},{"group":"Pages","pages":[{"title":"Create a page","openapi":"POST /{team_id}/pages","href":"/api-docs/pages/create-a-page"},{"title":"Update a page property","openapi":"PATCH /{team_id}/pages/{page_id}","href":"/api-docs/pages/update-a-page"},{"title":"Replace a page's content","openapi":"PUT /{team_id}/pages/{page_id}/content","href":"/api-docs/pages/replace-a-page-content"},{"title":"Get a page","openapi":"GET /{team_id}/pages/{page_id}","href":"/api-docs/pages/get-a-page"},{"title":"Duplicate a page","openapi":"POST /{team_id}/pages/{page_id}/copy","href":"/api-docs/pages/duplicate-a-page"},{"title":"Get pages","openapi":"GET /{team_id}/pages","href":"/api-docs/pages/get-pages"},{"title":"Archive a page","openapi":"PUT /{team_id}/pages/{page_id}/archive","href":"/api-docs/pages/archive-a-page"},{"title":"Delete a page","openapi":"DELETE /{team_id}/pages/{page_id}","href":"/api-docs/pages/delete-a-page"},{"title":"Delete a page icon","openapi":"DELETE /{team_id}/pages/{page_id}/icon","href":"/api-docs/pages/delete-page-icon"},{"title":"Delete a page cover image","openapi":"DELETE /{team_id}/pages/{page_id}/cover","href":"/api-docs/pages/delete-page-cover-image"}]},{"group":"Comments","pages":[{"title":"Create a comment","openapi":"POST /{team_id}/comments","href":"/api-docs/comments/create-a-comment"},{"title":"Edit a comment","openapi":"PATCH /{team_id}/comments/{comment_id}","href":"/api-docs/comments/edit-a-comment"},{"title":"Get a comment","openapi":"GET /{team_id}/comments/{comment_id}","href":"/api-docs/comments/get-a-comment"},{"title":"Get comments for a resource","openapi":"GET /{team_id}/comments","href":"/api-docs/comments/get-comments"},{"title":"Get replies to a comment","openapi":"GET /{team_id}/comments/{comment_id}/children","href":"/api-docs/comments/get-replies"},{"title":"Reply to a comment","openapi":"POST /{team_id}/comments/{comment_id}/children","href":"/api-docs/comments/reply-to-a-comment"},{"title":"Edit a reply","openapi":"PATCH /{team_id}/comments/{comment_id}/children/{child_comment_id}","href":"/api-docs/comments/edit-a-reply"},{"title":"Delete a reply","openapi":"DELETE /{team_id}/comments/{comment_id}/children/{child_comment_id}","href":"/api-docs/comments/delete-a-reply"},{"title":"Delete a comment","openapi":"DELETE /{team_id}/comments/{comment_id}","href":"/api-docs/comments/delete-a-comment"}]},{"group":"Boards","pages":[{"title":"Create a board","openapi":"POST /{team_id}/boards","href":"/api-docs/boards/create-a-board"},{"title":"Update a board","openapi":"PATCH /{team_id}/boards/{board_id}","href":"/api-docs/boards/update-a-board"},{"title":"Create a list","openapi":"POST /{team_id}/lists","href":"/api-docs/boards/create-a-list"},{"title":"Update a list","openapi":"PATCH /{team_id}/lists/{list_id}","href":"/api-docs/boards/update-a-list"},{"title":"Duplicate a board","openapi":"POST /{team_id}/boards/{board_id}/copy","href":"/api-docs/boards/duplicate-a-board"},{"title":"Get a board","openapi":"GET /{team_id}/boards/{board_id}","href":"/api-docs/boards/get-a-board"},{"title":"Get boards","openapi":"GET /{team_id}/boards","href":"/api-docs/boards/get-boards"},{"title":"Delete a board","openapi":"DELETE /{team_id}/boards/{board_id}","href":"/api-docs/boards/delete-a-board"}]},{"group":"Sprints","pages":[{"title":"Create a sprint","openapi":"POST /{team_id}/sprints","href":"/api-docs/sprints/create-a-sprint"},{"title":"Update a sprint","openapi":"PATCH /{team_id}/sprints/{sprint_id}","href":"/api-docs/sprints/update-a-sprint"},{"title":"Get a sprint","openapi":"GET /{team_id}/sprints/{sprint_id}","href":"/api-docs/sprints/get-a-sprint"},{"title":"Get sprints","openapi":"GET /{team_id}/sprints","href":"/api-docs/sprints/get-sprints"},{"title":"Get sprint settings","openapi":"GET /{team_id}/sprints/settings","href":"/api-docs/sprints/get-sprint-settings"},{"title":"Update sprint settings","openapi":"PUT /{team_id}/sprints/settings","href":"/api-docs/sprints/update-sprint-settings"}]},{"group":"Spaces","pages":[{"title":"Create a space","openapi":"POST /{team_id}/projects","href":"/api-docs/spaces/create-a-space"},{"title":"Update a space","openapi":"PATCH /{team_id}/projects/{project_id}","href":"/api-docs/spaces/update-a-space"},{"title":"Get a space","openapi":"GET /{team_id}/projects/{project_id}","href":"/api-docs/spaces/get-a-space"},{"title":"Get spaces","openapi":"GET /{team_id}/projects","href":"/api-docs/spaces/get-spaces"},{"title":"Add a member to a space","openapi":"POST /{team_id}/projects/{project_id}/members","href":"/api-docs/spaces/add-member-to-a-space"},{"title":"Remove a member from a space","openapi":"DELETE /{team_id}/projects/{project_id}/members/{user_id}","href":"/api-docs/spaces/remove-member-from-a-space"},{"title":"Delete a space","openapi":"DELETE /{team_id}/projects/{project_id}","href":"/api-docs/spaces/delete-a-space"}]},{"group":"Saved filters","pages":[{"title":"Create a saved filter","openapi":"POST /{team_id}/views","href":"/api-docs/saved-filters/create-a-saved-filter"},{"title":"Update a saved filter","openapi":"PATCH /{team_id}/views/{view_id}","href":"/api-docs/saved-filters/update-a-saved-filter"},{"title":"Get a saved filter","openapi":"GET /{team_id}/views/{view_id}","href":"/api-docs/saved-filters/get-a-saved-filter"},{"title":"Get saved filters","openapi":"GET /{team_id}/views","href":"/api-docs/saved-filters/get-saved-filters"},{"title":"Get saved filter results","openapi":"GET /{team_id}/views/{view_id}/results","href":"/api-docs/saved-filters/get-saved-filter-results"},{"title":"Find cards, pages or boards","openapi":"POST /{team_id}/views/preview","href":"/api-docs/saved-filters/find-cards-pages-or-boards"},{"title":"Delete a saved filter","openapi":"DELETE /{team_id}/views/{view_id}","href":"/api-docs/saved-filters/delete-a-saved-filter"}]},{"group":"Time tracking","pages":[{"title":"Query time reports","openapi":"GET /{team_id}/time/reports","href":"/api-docs/time-tracking/query-time-reports"},{"title":"Export time reports","openapi":"GET /{team_id}/time/reports/export","href":"/api-docs/time-tracking/export-time-reports"},{"title":"List time estimates","openapi":"GET /{team_id}/time/estimates","href":"/api-docs/time-tracking/list-time-estimates"},{"title":"Save a time estimate","openapi":"PATCH /{team_id}/time/estimates/{card_id}","href":"/api-docs/time-tracking/save-a-time-estimate"},{"title":"Get card time summary","openapi":"GET /{team_id}/time/cards/{card_id}","href":"/api-docs/time-tracking/get-card-time-summary"},{"title":"List space time tracking configs","openapi":"GET /{team_id}/time/tracking/spaces","href":"/api-docs/time-tracking/list-space-time-tracking-configs"},{"title":"Get time entry lock","openapi":"GET /{team_id}/time/tracking/lock","href":"/api-docs/time-tracking/get-time-entry-lock"},{"title":"List or aggregate time entries","openapi":"GET /{team_id}/time/entries","href":"/api-docs/time-tracking/list-or-aggregate-time-entries"},{"title":"Create a time entry","openapi":"POST /{team_id}/time/entries","href":"/api-docs/time-tracking/create-a-time-entry"},{"title":"Get a time entry","openapi":"GET /{team_id}/time/entries/{time_entry_id}","href":"/api-docs/time-tracking/get-a-time-entry"},{"title":"Update a time entry","openapi":"PATCH /{team_id}/time/entries/{time_entry_id}","href":"/api-docs/time-tracking/update-a-time-entry"},{"title":"Delete a time entry","openapi":"DELETE /{team_id}/time/entries/{time_entry_id}","href":"/api-docs/time-tracking/delete-a-time-entry"},{"title":"Get active timer","openapi":"GET /{team_id}/time/timer","href":"/api-docs/time-tracking/get-active-timer"},{"title":"Start a timer","openapi":"POST /{team_id}/time/timer","href":"/api-docs/time-tracking/start-a-timer"},{"title":"Stop a timer","openapi":"DELETE /{team_id}/time/timer","href":"/api-docs/time-tracking/stop-a-timer"},{"title":"List time categories","openapi":"GET /{team_id}/time/categories","href":"/api-docs/time-tracking/list-time-categories"},{"title":"Create a time category","openapi":"POST /{team_id}/time/categories","href":"/api-docs/time-tracking/create-a-time-category"},{"title":"Update a time category","openapi":"PATCH /{team_id}/time/categories/{time_category_id}","href":"/api-docs/time-tracking/update-a-time-category"},{"title":"Archive a time category","openapi":"DELETE /{team_id}/time/categories/{time_category_id}","href":"/api-docs/time-tracking/archive-a-time-category"},{"title":"Get workspace rate config","openapi":"GET /{team_id}/time/tracking/config","href":"/api-docs/time-tracking/get-workspace-rate-config"},{"title":"Update workspace rate config","openapi":"PATCH /{team_id}/time/tracking/config","href":"/api-docs/time-tracking/update-workspace-rate-config"},{"title":"Get space time tracking config","openapi":"GET /{team_id}/time/tracking/spaces/{project_id}/config","href":"/api-docs/time-tracking/get-space-time-tracking-config"},{"title":"Update space time tracking config","openapi":"PATCH /{team_id}/time/tracking/spaces/{project_id}/config","href":"/api-docs/time-tracking/update-space-time-tracking-config"},{"title":"List per-user rate overrides","openapi":"GET /{team_id}/time/tracking/overrides","href":"/api-docs/time-tracking/list-user-rate-overrides"},{"title":"Set a per-user rate override","openapi":"PUT /{team_id}/time/tracking/overrides","href":"/api-docs/time-tracking/set-user-rate-override"},{"title":"Clear a per-user rate override","openapi":"DELETE /{team_id}/time/tracking/overrides","href":"/api-docs/time-tracking/clear-user-rate-override"},{"title":"Lock time entries","openapi":"POST /{team_id}/time/tracking/lock","href":"/api-docs/time-tracking/lock-time-entries"},{"title":"Unlock time entries","openapi":"DELETE /{team_id}/time/tracking/lock","href":"/api-docs/time-tracking/unlock-time-entries"},{"title":"Query the time tracking audit log","openapi":"GET /{team_id}/time/tracking/audit","href":"/api-docs/time-tracking/query-time-tracking-audit-log"},{"title":"Time report by user","openapi":"GET /{team_id}/time/reports/user","href":"/api-docs/time-tracking/time-report-by-user"},{"title":"Time report by week","openapi":"GET /{team_id}/time/reports/week","href":"/api-docs/time-tracking/time-report-by-week"},{"title":"Time report by project","openapi":"GET /{team_id}/time/reports/project","href":"/api-docs/time-tracking/time-report-by-project"},{"title":"Time report by category","openapi":"GET /{team_id}/time/reports/category","href":"/api-docs/time-tracking/time-report-by-category"},{"title":"Time report by billable status","openapi":"GET /{team_id}/time/reports/billable","href":"/api-docs/time-tracking/time-report-by-billable"}]},{"group":"Search","pages":[{"title":"Get search results","openapi":"GET /{team_id}/search","href":"/api-docs/search/get-search-results"}]}]},{"tab":"CLI reference","pages":[{"title":"CLI reference","href":"/cli"}]}]},"basePath":"","title":"Create a note - Superthread help center","buildId":"dpl_4RHMRqtvdHvKgaEfTTjFqjzja3B6","deploymentId":"dpl_4RHMRqtvdHvKgaEfTTjFqjzja3B6","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-D_4Sesi0.js","utils-DRHeK26p.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C6d-DUc2.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dex7slho.js","snippetPresets-BcCEBp0Z.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-BoJxk0m8.js","ApiExamples-CufowNTX.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-A4lJSCIe.js","shallow-DqoHP7zn.js","getApiPlaygroundDisplay-Cku8AmtL.js","CodeSnippet-CtHQbNqc.js","CodeSnippets-CGo5Cslf.js","getPastedJson-M-bKdue4.js","icon-DEqCU4st.js","MethodPill-DnfSSXiJ.js","DuplicateIcon-BHu2PE8M.js","createIcon-BPsE5X7c.js","DynamicMarkdown-Dnt6YhtR.js","SectionHeading-6CtFWqMQ.js","axios-vUo_bRtp.js","Markdown-BoKe_1fI.js","clsx-DM5-sUNJ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CkIdkovK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-B3e6Nh_r.js"]}