Create Conversion

POST /siren/v1/conversions

Creates a new conversion record.

Request Body

Field	Type	Required	Description
`engagementId`	integer	Yes	ID of the associated engagement (must exist)
`type`	string	Yes	Conversion type identifier
`status`	string	Yes	Initial status: `pending`, `approved`, `rejected`, or `expired`
`transactionId`	integer	No	ID of associated transaction
`obligationId`	integer	No	ID of associated obligation

Example Request

{
  "engagementId": 15,
  "type": "sale",
  "status": "pending"
}

Example Response

{
  "id": 43,
  "engagementId": 15,
  "transactionId": null,
  "obligationId": null,
  "type": "sale",
  "status": "pending",
  "dateCreated": "2026-04-06T12:00:00Z",
  "dateModified": "2026-04-06T12:00:00Z"
}

Events

Broadcasts ConversionActionEvent (action: Create) after success.