---
title: "Applies a job flag to all jobs within the specified group"
method: POST
path: "/v1/jobGroups/{groupId}/jobFlags"
tags: ["Jobs"]
---

# Applies a job flag to all jobs within the specified group

`POST /v1/jobGroups/{groupId}/jobFlags`

## Request

- Base URL: `https://api.bigchange.com`
- URL: `https://api.bigchange.com/v1/jobGroups/{groupId}/jobFlags`
- Auth: HTTP bearer

Apply a job flag to all jobs within the specified group (required scope jobs:write)

## Path parameters

- `groupId` integer, required

## Headers

- `Customer-Id` integer, required

## Request body

- CreateEntityFlagModel: Request model for creating a flag on any supported entity type
  - `flagId` integer, required: The unique identifier of the flag to apply
  - `owner` string: User email or ID who owns the flag
  - `comments` string, nullable: Additional context for the flag

## Response `201`

Created

- ApplyJobGroupJobFlagResult: Represents the result of applying a job flag to a job group
  - `groupId` integer: The ID of the job group
  - `jobsFlaggedCount` integer: The number of jobs to which the flag was applied

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Content
- `500`: Internal Server Error

## Changes

- **2026-10-29** `5306509f5616`: 1 info
  - added the non-success response with the status `422`

[Operation history](https://skmtc.dev/bigchange/apis/bigchange-dx/changes/v1/jobGroups/:groupId/jobFlags/post.md)

---

[API](https://skmtc.dev/bigchange/apis/bigchange-dx.md) - [All operations](https://skmtc.dev/bigchange/apis/bigchange-dx/llms.txt) - [OpenAPI document](https://skmtc.dev/bigchange/apis/bigchange-dx/revisions/b262bfdb1dd0?raw)