Chat

Create a stateful chat

Create a persistent conversation whose history, context compression and rolling summary are managed server-side, then post turns with POST /v1/chats/{chatId}/messages. Pick exactly one shape: mindId for a 1:1 chat with a single Mind, mindIds for a multi-Mind conversation where a moderator decides which Mind answers each turn, or audienceIds for a Study chat that fans every message out to all Minds in the attached Audiences and returns aggregated output. Use this when you want the server to remember the conversation; use POST /v1/minds/{mindId}/completion when you manage history yourself. Minds must be owned by you, public, or shared with your team; Audiences must be ones you own, belong to, or that are public or shared with your team. Retired field names are rejected with 400 naming the replacement.

post/api/v1/chats

Request

  • Base URL: https://api.getminds.ai
  • URL: https://api.getminds.ai/api/v1/chats
  • Auth: HTTP bearer

Request body

namestring

Display name. Defaults to "API Chat" for Mind chats and "API Study" for Study chats.

descriptionstring

Optional free-text description.

mindIdstring uuid

Single Mind to chat with 1:1.

mindIdsstring[]

Two or more Minds for a moderated multi-Mind conversation (duplicates are ignored). A single-element array behaves like mindId.

audienceIdsstring[]

Audiences to attach to a Study chat. Every message fans out to all Minds in these Audiences.

Response

Existing response thread resumed.

Changes

No recorded changes to this operation across all 1 revision of this API.