Bulk Actions: Conversions
Perform actions on multiple conversions at once, including approval, rejection, and deletion.
Last updated: October 26, 2026
Bulk Actions
POST /siren/v1/conversions/bulk
Performs an action on multiple conversions at once.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
action | string | Yes | One of: approve, reject, markPending, delete, permanent_delete |
ids | integer[] | Yes | Array of conversion IDs to act upon |
Action Behaviors
| Action | Effect | Events |
|---|---|---|
approve | Approves the conversion via ConversionApproveService, which stores the status complete | Broadcasts ConversionApproved per record, which triggers MarkObligationsAsApproved to move the linked obligation from draft to approved |
reject | Sets status to rejected | Broadcasts ConversionRejected per record, which triggers RejectObligations to reject the linked obligation and take it out of any payout that hasn’t been sent |
markPending | Sets status to pending | Returns the linked obligation from approved to draft if it isn’t in a payout |
delete | Sets status to deleted (soft delete) | The linked obligation is left as it is, so an approved one is still paid |
permanent_delete | Permanently removes deleted conversions whose obligation no longer exists. All or nothing: if any conversion in the request can’t be removed, nothing is deleted and the request returns 409 | — |
Non-existent IDs are silently skipped. Datastore errors on individual records are logged but do not halt processing of remaining IDs.
Example Request
{
"action": "approve",
"ids": [1, 2, 3]
}
Example Response
{
"success": true,
"affected": 3
}