Minds

Poll a mind's training status

Returns the live training lifecycle for a mind. A mind's id exists the instant it is created, but it is only usable once readyToChat is true. Poll this endpoint after creating a mind in an auto mode (keywords, clone, link) until readyToChat flips true. The mind keeps learning from its sources in the background after that (learningInBackground, then fullyTrained); there is no need to wait for it. A Mind without a system prompt is never ready: it reports failed with error: { code: 'PROFILE_GEN_FAILED', retryable: true } (this covers manual-mode minds until their prompt is regenerated, and any Mind whose training ended without a prompt). Minds created before 2026-09-18T21:30:00Z keep their historical readiness. Statuses are queued, running, completed, failed (there is no idle). readyToChat reports that the mind can answer, NOT that it has researched evidence: read knowledgeState.fallbackOnly to tell a mind trained on collected sources apart from one answering from its generated profile alone. On failed, error.retryable indicates whether POST /v1/minds/{id}/retrain is worth calling.

get/api/v1/minds/{mindId}/training

Request

  • Base URL: https://api.getminds.ai
  • URL: https://api.getminds.ai/api/v1/minds/{mindId}/training
  • Auth: HTTP bearer

Path parameters

mindIdstring uuid required

Mind UUID.

Response

Training status.

status'queued' | 'running' | 'completed' | 'failed' required

Training lifecycle state. A failed attempt is retried automatically until the mind is ready, so it reports queued; failed is reported only for a mind without a system prompt, until it is retrained or its prompt is regenerated.

readyToChatboolean required

True when the mind can answer: training has completed, or it keeps answering with its current version while an update trains (servingPreviousVersion). This is the moment a mind (and an Audience whose minds all report it) is ready: chat and Studies can use it.

beingRepairedboolean

Present and true while the mind cannot answer yet because its last training attempt failed and it is retrained automatically (status is queued). Waiting for readiness may stop waiting for it: a Study runs without it when enough others answer.

servingPreviousVersionboolean

Present and true while an update of a ready mind trains: the mind keeps answering with its current version until the update lands.

learningInBackgroundboolean

True while a mind that is already readyToChat keeps learning from its sources in the background: a wider source collection, then a system prompt rebuilt from everything collected. Its answers can still deepen until it settles; nothing needs to wait for it.

fullyTrainedboolean

True once the mind is readyToChat and its background knowledge step has settled (learningInBackground false). Automatic validation of a new Audience waits for every member to be fully trained.

messagestring nullable

Human-readable progress / status message.

startedAtstring date-time nullable

When training started (null until running).

completedAtstring date-time nullable

When training finished (completed or failed).

Changes

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