Generate Fulfillments

POST /siren/v1/fulfillments/generate

Generates fulfillment batches from pending obligations. This is the primary action endpoint that bridges the obligation and payout stages of the pipeline. When called, it collects pending obligations, groups them by collaborator, creates payout records, and wraps them in a fulfillment batch.

Request Body

Field	Type	Required	Description
`obligationIds`	integer[]	No	Specific obligation IDs to process. If omitted, processes all pending obligations.

Examples

Send an empty body to process all pending obligations:

{}

To process specific obligations, pass their IDs:

{
  "obligationIds": [10, 11, 12]
}

Response:

{
  "success": true,
  "fulfillments": [
    {
      "id": 6,
      "status": "pending",
      "dateCreated": "2026-04-06T12:00:00Z",
      "dateModified": "2026-04-06T12:00:00Z"
    }
  ]
}

Returns 500 on a database error during generation.