v1

latestOpenAPI 3.1.02026-08-063776831.4 MB

Flag

Bulk Update Flag 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.

put/flags/update-status-bulk/{status}

Path parameters

statusstring required

The status to set for all flags (e.g., 'Closed', 'Open', 'seen')

Headers

tenant-idstring required

Tenant ID

Request body

flagIdsstring[] required

List of flag IDs to update

Example request

{
  "flagIds": [
    "flag-123",
    "flag-456",
    "flag-789"
  ]
}

Response

Bulk flag status update completed

totalCountinteger required

Total number of flags processed

successCountinteger required

Number of successful updates

failureCountinteger required

Number of failed updates

Example response

{
  "successful": [
    {
      "flagId": "flag-123"
    }
  ],
  "failed": [
    {
      "flagId": "flag-123"
    }
  ],
  "totalCount": 5,
  "successCount": 4,
  "failureCount": 1
}