---
title: User Flagging
url: https://docs.kaltura.com/docs/rich-media-cms-apis/content-moderation/moderation-user-flagging
---

## User Flagging

Users flag content via `baseEntry.flag`. This creates a moderation flag record and sets the entry status to `FLAGGED_FOR_REVIEW` (5). The entry remains playable during review.

### baseEntry.flag — Flag an Entry

```bash
curl -X POST "$KALTURA_SERVICE_URL/service/baseEntry/action/flag" \
  -d "ks=$KALTURA_KS" \
  -d "format=1" \
  -d "moderationFlag[objectType]=KalturaModerationFlag" \
  -d "moderationFlag[flaggedEntryId]=$KALTURA_ENTRY_ID" \
  -d "moderationFlag[flagType]=1" \
  -d "moderationFlag[comments]=Contains inappropriate content"
```

**Parameters:**

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `moderationFlag[flaggedEntryId]` | string | yes | Entry ID to flag |
| `moderationFlag[flagType]` | integer | yes | Flag reason (see Flag Types below) |
| `moderationFlag[comments]` | string | no | Free-text explanation (max 1024 chars) |

**Flag types (`KalturaModerationFlagType`):**

| Value | Name | Description |
|-------|------|-------------|
| 1 | SEXUAL_CONTENT | Nudity, pornography, or suggestive content |
| 2 | VIOLENT_REPULSIVE | Violence, gore, or repulsive content |
| 3 | HARMFUL_DANGEROUS | Harmful or dangerous acts |
| 4 | SPAM_COMMERCIALS | Spam or commercial promotion |
| 5 | COPYRIGHT | Copyright infringement |
| 6 | TERMS_OF_USE_VIOLATION | Violates terms of use |

**Validation:** The entry must be in `APPROVED` (2), `AUTO_APPROVED` (6), or `FLAGGED_FOR_REVIEW` (5) status. Flagging a `REJECTED` or `PENDING_MODERATION` entry returns `ENTRY_CANNOT_BE_FLAGGED`.

**Response:** Returns a `KalturaModerationFlag` object with the generated flag ID, status `PENDING` (1), and creation timestamp.

**Side effects:**
- Entry `moderationStatus` changes to `FLAGGED_FOR_REVIEW` (5) if not already
- Entry `moderationCount` increments by 1
- Email notifications fire to users with `CONTENT_MODERATE_APPROVE_REJECT` permission

**Permissions:** Flagging is broadly permitted — works with user sessions, widget sessions, and playback sessions. Anonymous flagging from widget KS is supported.

### baseEntry.listFlags — List Pending Flags

```bash
curl -X POST "$KALTURA_SERVICE_URL/service/baseEntry/action/listFlags" \
  -d "ks=$KALTURA_KS" \
  -d "format=1" \
  -d "entryId=$KALTURA_ENTRY_ID" \
  -d "pager[pageSize]=50"
```

**Response:**

```json
{
  "totalCount": 2,
  "objects": [
    {
      "id": 12345,
      "flaggedEntryId": "0_abc123",
      "flagType": 1,
      "comments": "Inappropriate content in first 30 seconds",
      "status": 1,
      "createdAt": 1700000000,
      "objectType": "KalturaModerationFlag"
    }
  ],
  "objectType": "KalturaModerationFlagListResponse"
}
```

Returns flags with `status=PENDING` (1). After `approve` or `reject`, flags are marked `MODERATED` (2) and no longer appear in this list.

**Flag status enum (`KalturaModerationFlagStatus`):**

| Value | Name |
|-------|------|
| 1 | PENDING |
| 2 | MODERATED |

**Permission:** Requires `CONTENT_MODERATE_BASE`.