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
​
title
string
required

Title for the collection. Use a short, stable label suitable for navigation and search. Maximum: 1,000 characters (and no more than 1,000 UTF-8 bytes).

Maximum string length: 1000
Example:

"Acme Corp"

​
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"

​
description
string | null

Optional descriptive text for collection scope or intent. Maximum: 10,000 characters (and no more than 10,000 UTF-8 bytes).

Maximum string length: 10000
Example:

"Anything related to Acme Corp; a software company that provides a suite of tools for managing customer relationships."

​
id
string<uuid> | null

Optional caller-provided UUID for the collection. If omitted, Mem generates a new UUID. If the provided ID already exists, this request returns a conflict.

​
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 created_at for the initial collection write.

Example:

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

Response

200 - application/json

OK

​
created_at
string<date-time>
required

Creation timestamp for the collection in ISO 8601 format.

​
description
string | null
required

Optional description text currently stored on the collection.

​
id
string<uuid>
required

UUID of the created collection.

​
request_id
string
required

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

​
title
string
required

Current title of the collection.

​
updated_at
string<date-time>
required

Last modification timestamp for the collection in ISO 8601 format.