Siren

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

FieldTypeRequiredDescription
actionstringYesOne of: approve, reject, markPending, delete, permanent_delete
idsinteger[]YesArray of conversion IDs to act upon

Action Behaviors

ActionEffectEvents
approveApproves the conversion via ConversionApproveService, which stores the status completeBroadcasts ConversionApproved per record, which triggers MarkObligationsAsApproved to move the linked obligation from draft to approved
rejectSets status to rejectedBroadcasts ConversionRejected per record, which triggers RejectObligations to reject the linked obligation and take it out of any payout that hasn’t been sent
markPendingSets status to pendingReturns the linked obligation from approved to draft if it isn’t in a payout
deleteSets status to deleted (soft delete)The linked obligation is left as it is, so an approved one is still paid
permanent_deletePermanently 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
}

Your privacy choices

Account, checkout and chat you request work without optional tracking. Choose whether to allow these other uses on this website.

You can change or withdraw your choices at any time using “Privacy choices.” We remember your choice for 180 days. Read our privacy policy.