---
title: "Create a new participant flag"
method: POST
path: "/cohorts/{id}/flags"
tags: ["Participant Flags"]
---

# Create a new participant flag

`POST /cohorts/{id}/flags`

## Request

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

Creates a flag for a participant (coach or system source)

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `participant_id` string, uuid, required
  - `source_type` 'coach' | 'system', required
  - `source_id` string, required
  - `flag_category` 'attendance' | 'participant_feedback' | 'engagement' | 'coach_flag', required
  - `flag_reason` string, required
  - `session_id` string, uuid

## Response `201`

Flag created

## Other responses

- `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)