POST /signal/retract

Retract a signal — decrement the edge weight between two entities.

method · POST

/signal/retract

Authentication: Required (if enabled)

Decrements the edge weight between two entities by 1, floored at 0.

Use this to correct erroneously ingested signals. Each retraction undoes one POST /signal ingest. The weight is never decremented below 0 — negative weights are architecturally forbidden because strongest_path uses DFS with backtracking to find the maximum-weight simple path, and negative weights would make the problem ill-defined.

Request Body

{
  "from_entity": 1,
  "to_entity": 2
}

Field	Type	Required	Description
from_entity	integer (u64)	Yes	Entity ID of the source node.
to_entity	integer (u64)	Yes	Entity ID of the destination node.

Response

200 OK — Decremented

{
  "success": true,
  "new_weight": 4,
  "error": null
}

Field	Type	Description
success	boolean	Whether the retraction was applied.
new_weight	integer or null	Updated edge weight (floored at 0) if successful.
error	string or null	Error message if failed.

The weight floor is 0, not −1. If you retract more times than you ingested, the weight stays at 0 rather than going negative.

Example

curl -X POST http://localhost:8080/signal/retract \
     -H "Authorization: Bearer your-api-key" \
     -H "Content-Type: application/json" \
     -d '{"from_entity": 1, "to_entity": 2}'