---
title: "Bulk Update Flag Status"
method: PUT
path: "/flags/update-status-bulk/{status}"
tags: ["Flag"]
---

# Bulk Update Flag Status

`PUT /flags/update-status-bulk/{status}`

Updates the status of multiple flags to the specified value in a single operation. Each flag is evaluated independently against the per-transition permission and the state machine; flags that fail (closed, illegal transition, missing permission) are reported in the failed list rather than aborting the batch.

## Path parameters

- `status` string, required

## Headers

- `tenant-id` string, required

## Request body

- BulkFlagStatusUpdateRequest — Request to update status of multiple flags
  - `flagIds` string[], required — List of flag IDs to update

## Response `200`

Bulk flag status update completed

- BulkFlagStatusUpdateResponse — Response containing results of bulk flag status update operation
  - `successful` StatusUpdateResult[], required — List of successful status updates
    - `flagId` string — Flag ID that was processed
    - `flagResponse` FlagResponse
      - `id` string
      - `tenantProviderId` string
      - `flagTypeId` string
      - `data` JsonNode
        - `empty` boolean
        - `valueNode` boolean
        - `containerNode` boolean
        - `missingNode` boolean
        - `array` boolean
        - `object` boolean
        - `nodeType` 'ARRAY' | 'BINARY' | 'BOOLEAN' | 'MISSING' | 'NULL' | 'NUMBER' | 'OBJECT' | 'POJO' | 'STRING'
        - `pojo` boolean
        - `number` boolean
        - `integralNumber` boolean
        - `floatingPointNumber` boolean
        - `short` boolean
        - `int` boolean
        - `long` boolean
        - `float` boolean
        - `double` boolean
        - `bigDecimal` boolean
        - `bigInteger` boolean
        - `textual` boolean
        - `boolean` boolean
        - `null` boolean
        - `binary` boolean
      - `createdAt` string, date
      - `createdBy` string
      - `updatedAt` string, date
      - `updatedBy` string
      - `originMonitoringWorkflowId` string
      - `hash` string
    - `errorMessage` string — Error message if the operation failed
    - `errorCode` string — Error code if the operation failed
  - `failed` StatusUpdateResult[], required — List of failed status updates
    - `flagId` string — Flag ID that was processed
    - `flagResponse` FlagResponse
      - `id` string
      - `tenantProviderId` string
      - `flagTypeId` string
      - `data` JsonNode
        - `empty` boolean
        - `valueNode` boolean
        - `containerNode` boolean
        - `missingNode` boolean
        - `array` boolean
        - `object` boolean
        - `nodeType` 'ARRAY' | 'BINARY' | 'BOOLEAN' | 'MISSING' | 'NULL' | 'NUMBER' | 'OBJECT' | 'POJO' | 'STRING'
        - `pojo` boolean
        - `number` boolean
        - `integralNumber` boolean
        - `floatingPointNumber` boolean
        - `short` boolean
        - `int` boolean
        - `long` boolean
        - `float` boolean
        - `double` boolean
        - `bigDecimal` boolean
        - `bigInteger` boolean
        - `textual` boolean
        - `boolean` boolean
        - `null` boolean
        - `binary` boolean
      - `createdAt` string, date
      - `createdBy` string
      - `updatedAt` string, date
      - `updatedBy` string
      - `originMonitoringWorkflowId` string
      - `hash` string
    - `errorMessage` string — Error message if the operation failed
    - `errorCode` string — Error code if the operation failed
  - `totalCount` integer, required — Total number of flags processed
  - `successCount` integer, required — Number of successful updates
  - `failureCount` integer, required — Number of failed updates

## Other responses

- `400` — Bad request - Invalid request parameters or missing required headers
- `401` — Authentication required - Valid authentication token is missing or invalid
- `403` — Forbidden - Caller lacks any of the per-transition permissions required to use this endpoint
- `500` — Internal server error - An unexpected error occurred while processing the request

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/revisions/3d27e9019c7b/schema)