Fulfillment Bulk Actions

Fulfillment Bulk Actions

POST /siren/v1/fulfillments/bulk

Performs an action on multiple fulfillments at once. This endpoint enforces valid state transitions. Invalid transitions are silently skipped.

Request Body

Field	Type	Required	Description
action	string	Yes	One of: process, complete, fail, delete
ids	integer[]	Yes	Array of fulfillment IDs to act upon

Action Behaviors and Valid Transitions

Action	Status Set	Valid From	Auth Required
process	processing	pending only	Update
complete	complete	processing only	Update
fail	failed	pending or processing	Update
delete	(record removed)	any status	Delete

Records that do not meet the “Valid From” precondition are silently skipped. The affected count in the response reflects only the records that were actually changed.

Example

{
  "action": "process",
  "ids": [5, 6, 7]
}

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