Sign in

v1

latestOpenAPI 3.1.02026-07-26183980.3 KB
external
external-v2

Create Collection

Create a collection with optional caller-provided ID and timestamps. If id already exists, this request returns a conflict. Use collection membership endpoints to add, remove, or move notes between collections.

post/v2/collections

Request body

created_atstring date-time nullable

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.

descriptionstring nullable

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

idstring uuid nullable

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.

titlestring 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).

updated_atstring date-time nullable

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 request

{
  "created_at": "2025-04-01T14:30:45Z",
  "description": "Anything related to Acme Corp; a software company that provides a suite of tools for managing customer relationships.",
  "title": "Acme Corp",
  "updated_at": "2025-04-02T09:15:22Z"
}

Response

OK

created_atstring date-time required

Creation timestamp for the collection in ISO 8601 format.

descriptionstring nullable required

Optional description text currently stored on the collection.

idstring uuid required

UUID of the created collection.

request_idstring required

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

titlestring required

Current title of the collection.

updated_atstring date-time required

Last modification timestamp for the collection in ISO 8601 format.

Example response

{
  "created_at": "2025-04-11T04:47:14.457Z",
  "description": "Anything related to Acme Corp; a software company that provides a suite of tools for managing customer relationships.",
  "id": "5e29c8a2-c73b-476b-9311-e2579712d4b1",
  "request_id": "api-request-036ed6c7-de00-459f-a89b-43d26aafe522",
  "title": "Acme Corp",
  "updated_at": "2025-04-11T04:47:19.702Z"
}