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.
Request
- Base URL: https://api.getminds.ai
- URL: https://api.getminds.ai/api/v1/audiences/{audienceId}
- Auth: HTTP bearer
Path parameters
Audience ID (UUID).
Query parameters
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.