sessions.create()

const { token, expiresAt } = await concatflow.sessions.create({
  assistantId: process.env.CONCATFLOW_ASSISTANT_ID!,
  partitions: { customer_id: req.user.customerId },
});

​

Parameters

​

Returns

{ "token": "Qm8x…", "expiresAt": "2026-10-23T14:37:12.204000+00:00" }

​

Behaviour

• One conversation per customer. The first session for a partition creates the conversation. Later sessions, even concurrent ones, join it.
• Short tokens, long conversations. A token lasts 15 minutes. The conversation stays until you erase it.
• No customer data in the browser. The partition stays on Concatflow’s side. Only its hash is used to find the conversation.

​

Validation

• assistantId is empty or not a string;
• partitions is not an object, or has no key;
• a key or value is empty, or a number is not finite.

​

Errors