Siren

Credit Metric

Manually credits a metric to a collaborator, triggering the manual metric attribution pipeline across active distributors.

Last updated: April 9, 2026

Credit Metric

POST /siren/v1/distributors/credit-metric

Manually credits a metric to a collaborator. This triggers the manual metric attribution pipeline, which creates or updates metric records for every active distributor that has a manual metric type configured for the given collaborator.

This endpoint lives under /distributors rather than /distributions because it acts on the distributor configuration layer, not on distribution records directly.

Request Body:

FieldTypeRequiredDescription
collaboratorIdintegerYesID of the collaborator to credit

Example Request:

{
  "collaboratorId": 42
}

Example Response:

{
  "success": true
}

Error Responses:

  • 404. Collaborator not found.
  • 500. Database error.

Events: Broadcasts ManualMetricRequested after success, which the Manual trigger strategy handles to update metric records across applicable distributors.