Minds

Regenerate a Mind's profile image

Queue AI generation of a new profile image for a Mind. The request returns as soon as the job is enqueued; poll GET /v1/minds/{mindId} until profileImageUrl is set or changes. The job is idempotent: when the Mind already has an image the endpoint returns enqueued: false with a skippedReason unless force: true, in which case the current image stays visible until a fresh portrait generated from the Mind's name, discipline, and system prompt replaces it. Pass personaContext to steer the image prompt without altering the stored system prompt. Callable by the owner or by a direct Mind member with the admin role; everyone else gets 403 Forbidden.

post/api/v1/minds/{mindId}/regenerate-image

Request

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

Path parameters

mindIdstring uuid required

Mind UUID.

Request body

forceboolean

Regenerate even when a profile image is already set.

personaContextstring

Optional persona description fed to the image-prompt generator instead of the default "name — discipline". Trimmed; blank values are ignored.

Response

Job enqueued, or skipped because an image already exists.

successtrue required

Changes

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