Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
content
string
required

Full markdown body for the note. Send the full desired note body (partial patch semantics are not supported here). IMPORTANT: The first line is interpreted as the note title. Maximum: 200,000 characters (and no more than 200,000 UTF-8 bytes on create).

Maximum string length: 200000
Example:

"# Meeting with Product Team\n\nDiscussion Topics:\n- Roadmap updates\n- Feature prioritization\n\nAction Items:\n- Schedule follow-up with design\n- Share Q2 priorities document"

collection_ids
string<uuid>[] | null

Optional collection IDs to associate with the note. IDs that do not map to accessible collections are ignored.

collection_titles
string[] | null

Optional collection titles to associate with the note. Matching is case-insensitive exact match; titles with no match are ignored. Maximum per title: 1,000 characters (and no more than 1,000 UTF-8 bytes).

Collection title used for exact case-insensitive matching in collection_titles. Maximum: 1,000 characters.

Maximum string length: 1000
Example:
created_at
string<date-time> | null

Optional creation timestamp (ISO 8601). If provided, it must include a timezone offset and cannot be in the future. If omitted, Mem uses updated_at when provided; otherwise current server time.

Example:

"2025-04-01T14:30:45Z"

id
string<uuid> | null

Optional UUID for the note. If omitted, Mem generates a new UUID.

updated_at
string<date-time> | null

Optional "last updated" timestamp for this write (ISO 8601). If provided, it must include a timezone offset and cannot be in the future. If omitted, Mem uses the current server time for the initial content write.

Example:

"2025-04-02T09:15:22Z"

Response

OK

collection_ids
string<uuid>[]
required

Collection UUIDs currently associated with this note.

content
string
required

Full markdown content stored for the note.

created_at
string<date-time>
required

Creation timestamp for the note in ISO 8601 format.

id
string<uuid>
required

UUID of the created note.

request_id
string
required

Identifier for this API request. Useful for tracing and support.

title
string
required

Current note title, derived from the first line of markdown content.

updated_at
string<date-time>
required

Last modification timestamp for the note in ISO 8601 format.

version
integer
required

Current note content document version after this write.