---
title: "Announce all ready modalities in a cohort"
method: POST
path: "/cohorts/{id}/announce-all"
tags: ["Cohorts"]
---

# Announce all ready modalities in a cohort

`POST /cohorts/{id}/announce-all`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/cohorts/{id}/announce-all`
- Auth: HTTP bearer

Announces all configured modalities simultaneously. Sends a single consolidated invitation email to participants. Optionally accepts specific modality IDs to announce only a subset.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `sendInvites` boolean, required: If true, sends a consolidated invitation email to all active participants
  - `modalityIds` string[]: Optional subset of modality IDs to announce. If omitted, all ready modalities are announced.

## Response `201`

Modalities announced successfully

## Other responses

- `400`: Validation error
- `401`: Unauthorized
- `404`: Cohort not found

---

[API](https://skmtc.dev/withmedley/apis/medley-api.md) - [All operations](https://skmtc.dev/withmedley/apis/medley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withmedley/apis/medley-api/revisions/40aaac5ca6bd?raw)