Get / Update / Delete Gate

Manage a review gate by UUID: GET returns the gate with active rules, PUT applies a partial update, DELETE soft-deletes it without losing queue items.

/v1/structuring/gates/{id} manages a single review gate. GET returns the gate with its active rules embedded. PUT applies a partial update to gate properties (name, on_approve, on_flag, auto_approve_after_hours, destination_id, is_active); the schema scope is fixed at creation. DELETE soft-deletes the gate by setting is_active to false.

Response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Finance approval gate",
  "user_schema_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "destination_id": null,
  "on_approve": "export",
  "on_flag": "queue",
  "auto_approve_after_hours": null,
  "is_active": true,
  "rules": [
    {
      "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
      "name": "Minimum confidence",
      "type": "min_confidence",
      "config": { "threshold": 0.85 },
      "sort_order": 0
    }
  ],
  "created_at": "2024-09-01T10:00:00.000Z",
  "updated_at": "2024-09-15T09:00:00.000Z",
  "links": {
    "self": "/v1/structuring/gates/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "rules": "/v1/structuring/gates/a1b2c3d4-e5f6-7890-abcd-ef1234567890/rules"
  }
}

{
  "deleted": true
}

Errors

The rules array is only populated on GET responses. After a PUT update, re-fetch with GET to confirm the current rule set. DELETE soft-deletes the gate by setting is_active to false -- pending review items already queued by this gate remain in the queue and can still be actioned manually.