# Minds Audiences API

**Canonical:** https://apis.io/apis/getminds/getminds-audiences-api/  
**Provider:** Minds — https://apis.io/providers/getminds/  
**Base URL:** https://getminds.ai/api/v1  
**Documentation:** https://getminds.ai/docs/api/overview

Minds Audiences API is one of 15 APIs that [Minds](https://apis.io/providers/getminds/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Audiences. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

The Audiences API from Minds — 24 operation(s) for audiences.

## Operations (30)

| Method | Path | Summary |
|---|---|---|
| DELETE | `/api/v1/audiences/{audienceId}` | Delete an Audience |
| GET | `/api/v1/audiences/{audienceId}` | Get an Audience |
| PUT | `/api/v1/audiences/{audienceId}` | Update an Audience name and sharing settings |
| GET | `/api/v1/audiences/{audienceId}/export-download` | Download an Audience export |
| GET | `/api/v1/audiences/{audienceId}/export-status` | Get Audience export status |
| POST | `/api/v1/audiences/{audienceId}/export` | Export an Audience brief |
| DELETE | `/api/v1/audiences/{audienceId}/follow` | Unfollow a public Audience |
| POST | `/api/v1/audiences/{audienceId}/follow` | Follow a public Audience |
| DELETE | `/api/v1/audiences/{audienceId}/formations/{formationId}` | Delete a Formation |
| GET | `/api/v1/audiences/{audienceId}/formations/{formationId}` | Get a Formation with its subgroups and members |
| POST | `/api/v1/audiences/{audienceId}/formations/{formationId}/recompute` | Re-sort the current members into an existing Formation |
| GET | `/api/v1/audiences/{audienceId}/formations` | List the Formations of an Audience |
| POST | `/api/v1/audiences/{audienceId}/formations` | Create a Formation from an accepted hypothesis |
| POST | `/api/v1/audiences/{audienceId}/formations/preview` | Propose Formation subgroups without creating anything |
| POST | `/api/v1/audiences/{audienceId}/members` | Add Minds to an Audience |
| DELETE | `/api/v1/audiences/{audienceId}/members/{mindId}` | Remove a Mind from an Audience |
| GET | `/api/v1/audiences/{audienceId}/progress` | Get the current creation progress for an Audience |
| POST | `/api/v1/audiences/{audienceId}/recalibrate` | Recalibrate an Audience's grounding and members |
| POST | `/api/v1/audiences/{audienceId}/regenerate-images` | Queue profile-image generation for the Minds in an Audience |
| GET | `/api/v1/audiences/active-progress` | List active Audience creation progress |
| POST | `/api/v1/audiences/allocation-preview` | Preview deterministic cohort allocation |
| POST | `/api/v1/audiences/from-brief` | Create a grounded audience from a brief |
| GET | `/api/v1/audiences/from-brief/jobs/{jobId}` | Get a from-brief Audience preview or creation operation |
| POST | `/api/v1/audiences/from-brief/segmentation-preview` | Preview spreadsheet segmentation distributions |
| GET | `/api/v1/audiences` | List visible Audiences |
| POST | `/api/v1/audiences` | Create an Audience from existing Minds |
| GET | `/api/v1/audiences/library` | List the first-party Audience library projection |
| GET | `/api/v1/audiences/lifecycle/stream` | Stream Audience lifecycle invalidations |
| GET | `/api/v1/audiences/limits` | Audience creation limits for the authenticated account |
| POST | `/api/v1/audiences/source-import` | Import supplied UTF-8 audience research sources |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/getminds/refs/heads/main/openapi/getminds-audiences-api-openapi.yml
- **Documentation** — https://getminds.ai/docs/api/overview
- **APIReference** — https://getminds.ai/docs/api/reference
- **LLMsTxt** — https://getminds.ai/llms.txt
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/getminds/refs/heads/main/authentication/getminds-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/getminds/refs/heads/main/conventions/getminds-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/getminds/refs/heads/main/errors/getminds-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/getminds/refs/heads/main/data-model/getminds-data-model.yml

## Other Minds APIs (12)

- [Minds MCP Server](https://apis.io/apis/getminds/minds-mcp-server/)
- [Minds Agent Runs API](https://apis.io/apis/getminds/getminds-agent-runs-api/)
- [Minds API Keys API](https://apis.io/apis/getminds/getminds-api-keys-api/)
- [Minds Auth API](https://apis.io/apis/getminds/getminds-auth-api/)
- [Minds Chat API](https://apis.io/apis/getminds/getminds-chat-api/)
- [Minds Knowledge API](https://apis.io/apis/getminds/getminds-knowledge-api/)
- [Minds Meta API](https://apis.io/apis/getminds/getminds-meta-api/)
- [Minds Minds API](https://apis.io/apis/getminds/getminds-minds-api/)
- [Minds Models API](https://apis.io/apis/getminds/getminds-models-api/)
- [Minds Research API](https://apis.io/apis/getminds/getminds-research-api/)
- [Minds Studies API](https://apis.io/apis/getminds/getminds-studies-api/)
- [Minds Study Drafts API](https://apis.io/apis/getminds/getminds-study-drafts-api/)

## Tags

Audiences

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/getminds/getminds-audiences-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/getminds/.