Siren

Bulk Actions

Performs an action on multiple distributors at once, including activate, deactivate, restore, delete, and permanent delete.

Last updated: April 9, 2026

Bulk Actions

POST /siren/v1/distributors/bulk

Performs an action on multiple distributors at once.

Request Body:

FieldTypeRequiredDescription
actionstringYesOne of: activate, deactivate, restore, delete, permanent_delete
idsinteger[]YesArray of distributor IDs to act upon

Action Behaviors:

ActionEffectAuth Required
activateSets status to activeUpdate
deactivateSets status to inactiveUpdate
restoreSets status to inactive (restores from trash for review)Update
deleteSets status to deleted (soft delete)Delete
permanent_deletePermanently removes records from databaseDelete

Non-existent IDs are silently skipped. Datastore errors on individual records are logged but do not halt processing of remaining IDs.

Example Request:

{
  "action": "activate",
  "ids": [1, 2, 3]
}

Example Response:

{
  "success": true,
  "affected": 3
}