fix: ensure local baserow upsert service handles field constraint errors (baserow#5081)

* Ensure local baserow upsert handles unique constraint

* Fix hard-coded ids

* Reword 'unique' to 'field'

Author: paljort

backend/src/baserow/contrib/integrations/local_baserow/service_types.py

@@ -30,6 +30,7 @@
 )
 from baserow.contrib.database.api.utils import extract_field_ids_from_list
 from baserow.contrib.database.fields.exceptions import (
+    FieldDataConstraintException,
     FieldDoesNotExist,
     IncompatibleField,
 )
@@ -2143,6 +2144,10 @@ def dispatch_data(
                 raise ServiceImproperlyConfiguredDispatchException(
                     f"The row with id {row_id} does not exist."
                 ) from exc
+            except FieldDataConstraintException as exc:
+                raise InvalidContextContentDispatchException(
+                    f"The row with id {row_id} violates a field constraint."
+                ) from exc
         else:
             try:
                 (row,) = CreateRowsActionType.do(
@@ -2156,6 +2161,11 @@ def dispatch_data(
                     f"Cannot create rows in table {table.id} because "
                     "it has a data sync."
                 ) from exc
+            except FieldDataConstraintException as exc:
+                raise InvalidContextContentDispatchException(
+                    f"Cannot create rows in table {table.id} because "
+                    "it violates a field constraint."
+                ) from exc
 
         return {
             "data": row,

backend/tests/baserow/contrib/builder/api/workflow_actions/test_workflow_actions_views.py

@@ -22,6 +22,10 @@
     NotificationWorkflowActionType,
     UpdateRowWorkflowActionType,
 )
+from baserow.contrib.database.fields.field_constraints import (
+    TextTypeUniqueWithEmptyConstraint,
+)
+from baserow.contrib.database.fields.handler import FieldHandler
 from baserow.contrib.database.rows.handler import RowHandler
 from baserow.contrib.database.table.handler import TableHandler
 from baserow.contrib.integrations.local_baserow.service_types import (
@@ -638,6 +642,58 @@ def test_dispatch_local_baserow_create_row_workflow_action(api_client, data_fixt
     assert animal_field.name not in response_json
 
 
+@pytest.mark.django_db
+def test_dispatch_local_baserow_create_row_workflow_action_field_constraint(
+    api_client, data_fixture
+):
+    user, token = data_fixture.create_user_and_token()
+    table = data_fixture.create_database_table(user=user)
+
+    # Create a field that has a constraint, e.g. unique
+    fruit_field = FieldHandler().create_field(
+        user=user,
+        table=table,
+        type_name="text",
+        name="Unique fruit",
+        field_constraints=[
+            {"type_name": TextTypeUniqueWithEmptyConstraint.constraint_name}
+        ],
+    )
+
+    model = table.get_model()
+    model.objects.create(**{f"field_{fruit_field.id}": "Apple"})
+
+    builder = data_fixture.create_builder_application(user=user)
+    page = data_fixture.create_builder_page(user=user, builder=builder)
+    element = data_fixture.create_builder_button_element(page=page)
+    workflow_action = data_fixture.create_local_baserow_create_row_workflow_action(
+        page=page, element=element, event=EventTypes.CLICK, user=user
+    )
+    service = workflow_action.service.specific
+    service.table = table
+    service.field_mappings.create(field=fruit_field, value="'Apple'")
+    service.save()
+
+    url = reverse(
+        "api:builder:workflow_action:dispatch",
+        kwargs={"workflow_action_id": workflow_action.id},
+    )
+    response = api_client.post(
+        url,
+        {},
+        format="json",
+        HTTP_AUTHORIZATION=f"JWT {token}",
+    )
+
+    assert response.status_code == HTTP_400_BAD_REQUEST
+    response_json = response.json()
+    assert response_json["error"] == "ERROR_SERVICE_INVALID_DISPATCH_CONTEXT_CONTENT"
+    assert (
+        response_json["detail"]
+        == f"Cannot create rows in table {table.id} because it violates a field constraint."
+    )
+
+
 @pytest.mark.django_db
 def test_dispatch_local_baserow_update_row_workflow_action(api_client, data_fixture):
     user, token = data_fixture.create_user_and_token()
@@ -696,6 +752,61 @@ def test_dispatch_local_baserow_update_row_workflow_action(api_client, data_fixt
     assert animal_field.name not in response_json
 
 
+@pytest.mark.django_db
+def test_dispatch_local_baserow_update_row_workflow_action_field_constraint(
+    api_client, data_fixture
+):
+    user, token = data_fixture.create_user_and_token()
+    table = data_fixture.create_database_table(user=user)
+
+    # Create a field that has a constraint, e.g. unique
+    fruit_field = FieldHandler().create_field(
+        user=user,
+        table=table,
+        type_name="text",
+        name="Unique fruit",
+        field_constraints=[
+            {"type_name": TextTypeUniqueWithEmptyConstraint.constraint_name}
+        ],
+    )
+
+    model = table.get_model()
+    model.objects.create(**{f"field_{fruit_field.id}": "Apple"})
+    # Create another row, which we'll update to 'Apple' to simulate a unique constraint
+    second_row = model.objects.create(**{f"field_{fruit_field.id}": "Banana"})
+
+    builder = data_fixture.create_builder_application(user=user)
+    page = data_fixture.create_builder_page(user=user, builder=builder)
+    element = data_fixture.create_builder_button_element(page=page)
+    workflow_action = data_fixture.create_local_baserow_create_row_workflow_action(
+        page=page, element=element, event=EventTypes.CLICK, user=user
+    )
+    service = workflow_action.service.specific
+    service.table = table
+    service.row_id = f"'{second_row.id}'"
+    service.field_mappings.create(field=fruit_field, value="'Apple'")
+    service.save()
+
+    url = reverse(
+        "api:builder:workflow_action:dispatch",
+        kwargs={"workflow_action_id": workflow_action.id},
+    )
+    response = api_client.post(
+        url,
+        {},
+        format="json",
+        HTTP_AUTHORIZATION=f"JWT {token}",
+    )
+
+    assert response.status_code == HTTP_400_BAD_REQUEST
+    response_json = response.json()
+    assert response_json["error"] == "ERROR_SERVICE_INVALID_DISPATCH_CONTEXT_CONTENT"
+    assert (
+        response_json["detail"]
+        == f"The row with id {second_row.id} violates a field constraint."
+    )
+
+
 @pytest.mark.django_db
 def test_dispatch_local_baserow_upsert_row_workflow_action_with_current_record(
     api_client, data_fixture

changelog/entries/unreleased/bug/ensure_local_baserow_upsert_integration_handles_unique_const.json

@@ -0,0 +1,9 @@
+{
+    "type": "bug",
+    "message": "Ensure Local Baserow Upsert integration handles field constraint errors.",
+    "issue_origin": "github",
+    "issue_number": null,
+    "domain": "integration",
+    "bullet_points": [],
+    "created_at": "2026-03-30"
+}