Audiences

Get an Audience

Returns one Audience with its member Minds (each with its cohort profile), the caller's role, the stored grounding, the source bundle (brief, adjustments, keywords, links, files), member-derived baseline distributions, and the transient recalibration state. Use it to inspect an Audience before attaching it to a Study, to poll calibration.active after POST /audiences/{audienceId}/recalibrate, or to watch member profileImageUrl values arrive after regenerate-images. Formations are not embedded; list them with GET /audiences/{audienceId}/formations. Readable by the owner, direct members, members of the owner's team when the Audience is team-shared, any authenticated caller when the Audience is public, and members of a Study that contains the Audience. Setting isSharedWithTeam: true lets every member of the owner's team open the Audience and read and chat with every Mind in it, even when those Minds are not shared individually; it grants no edit rights on the Minds. Explicit Audience members get the same read access. Only collaborators (owner, direct member, team member) receive the sharing fields isSharedWithTeam, isLinkSharingEnabled and publicShareId; public and Study-cascade viewers get currentMemberRole: public_viewer, and uploaded-file URLs in sources and grounding.sources are redacted for them.

get/api/v1/audiences/{audienceId}

Request

  • Base URL: https://api.getminds.ai
  • URL: https://api.getminds.ai/api/v1/audiences/{audienceId}
  • Auth: HTTP bearer

Path parameters

audienceIdstring uuid required

Audience ID (UUID).

Query parameters

members'preview'

Use preview for bounded display profiles without reviewed-field metadata; omitted preserves the complete legacy detail response.

Response

The Audience detail.

Changes

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