Credit Collaborator

POST /siren/v1/transactions/credit-collaborator

Attributes one or more existing transactions to a collaborator. For each transaction, the system creates an engagement, conversion, and obligation through the manual attribution pipeline. This is the mechanism for retroactively crediting a collaborator for transactions that were not originally tracked through a referral link. See Manually Attribute a Transaction for a user-level overview of when and how to use this feature.

Request Body:

Field	Type	Required	Description
`transactionIds`	integer[]	Yes	Array of transaction IDs to credit
`collaboratorId`	integer	Yes	ID of the collaborator to credit
`type`	string	No	Conversion type (defaults to `sale`)

The collaboratorId field supports collaborator alias resolution. If a collaborator alias is provided, it is automatically resolved to the canonical collaborator ID via middleware.

Example Request:

{
  "transactionIds": [101, 102, 103],
  "collaboratorId": 42,
  "type": "sale"
}

Example Response:

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

Non-existent transaction IDs are silently skipped. Datastore errors on individual transactions are logged but do not halt processing of the remaining IDs.

Error Responses:

404. Collaborator not found.
500. Error fetching collaborator.