Minds

Create a Mind

Create a new AI Mind. Choose a training mode: keywords (default) seeds from keyword topics, clone emulates a named person/profile, link scrapes a URL, manual skips automatic data collection. The returned training block reflects the Mind's lifecycle: auto-processing modes start queued (poll GET /v1/minds/{id}/training until readyToChat is true), while manual Minds skip collection and have no system prompt yet, so they report failed (PROFILE_GEN_FAILED, retryable, readyToChat: false) until you add knowledge and call POST /v1/minds/{id}/regenerate-prompt; a Mind without a system prompt is never ready. A Mind's id exists before it is ready; do not chat until readyToChat is true.

post/api/v1/minds

Request

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

Headers

X-Minds-Idempotency-Keystring

Stable key for one creation operation, scoped to the authenticated owner. Reuse it with the same payload after a timeout; while the original Mind exists and remains accessible in the current workspace, the key returns that Mind with HTTP 200. Use a fresh key to create another Mind.

Request body

namestring required

Mind display name.

disciplinestring required

Area of expertise (e.g. "Marketing", "Engineering").

descriptionstring

Short summary. Defaults to "Created via API".

mode'keywords' | 'clone' | 'link' | 'manual'

Training mode.

type'creative' | 'expert' | 'user'
keywordsstring[]

Required when mode=keywords.

personaContextstring

Required when mode=clone (name + brief context of the person to emulate).

contextLinkstring uri

Required when mode=link (URL the AI will scrape).

linkstring uri

Deprecated alias for contextLink.

tagsstring[]
profileImageUrlstring uri

Public HTTP(S) raster avatar URL. Remote downloads are limited to 50 MiB and 30 seconds; private destinations and SVG are refused. If download or storage fails, creation retains the original URL.

generateImageboolean

Trigger async AI profile-image generation after creation. Defaults to true for auto-training modes; pass false to opt out.

includeWebSearchboolean

Set false to skip automatic web research. For a strictly private source-only Mind, use mode=manual, upload knowledge, then regenerate the prompt.

isRealPersonboolean

Whether the Mind emulates a real, named person. Defaults to true for mode=clone and false otherwise. Synthetic Minds (false) get name-blind persona prompts: the name is a label, never the seed of the biography.

sourcePolicy'auto' | 'knowledge_only'

Persisted source policy. knowledge_only always retrieves processed Mind knowledge and fails closed when it cannot support the answer. In a Study it still reads the stimulus a question is asked about (attached files, images, links), never as a source of facts.

isLinkSharingEnabledboolean

Enable link sharing; generates a publicShareId.

localestring

ISO 639-1 code for the auto-generated description language. Falls back to the user's preferredLanguage, then en.

Response

Mind created. The training block carries the initial lifecycle state: queued for auto modes; for manual, not ready (failed, retryable) until a system prompt is generated via regenerate-prompt.

Changes

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