Collections

A collection is a namespace inside your organization. Use one per product, environment, or agent. Calls without a collection use the default bucket.

Create collections in the dashboard. Pass the code (not an internal id) on SDK clients, REST bodies, or MCP tool calls.

const memory = new GomindClient(
  "https://api.gominddb.com",
  process.env.GOMIND_API_KEY!,
  { collection: "my-project" },
);

Precedence

First match wins:

1. JSON body collection — including "", which forces the default bucket
2. Query ?collection=
3. Header X-Gomind-Collection
4. Default bucket

On MCP, omit collection or pass "" to use the default bucket. A mind session is the only forced pin. Pass a code from list_collections to target another collection the caller can access.

Aliases default, null, none, nil, and undefined also mean the default bucket.

Unknown codes

A code that does not exist returns 404. The call is not billed.

One batch, one collection

remember_many commits the whole batch to a single collection. A per-fact collection is allowed only when it matches the batch. Split mixed namespaces into separate calls.

MCP list_collections returns the codes you can pass.