Action endpoints

Bulk actions, row actions, and row refetch routes

Bulk table action

POST /api/api-table/control-tables/bulk-table-action/{tableName}/{action}

Executes a bulk action defined via TableBulkAction (e.g. export_excel).

Common body fields:

{
  "selected_ids": [1, 2, 3],
  "filters": [],
  "emails": ["user@example.com"]
}

Response depends on ActionsResponseWith:

TypeBehavior
instantImmediate JSON or file download
emailQueues email report
notificationIn-app notification payload
websocketWebSocket broadcast payload

Row action

POST /api/api-table/control-tables/row-table-action/{tableName}/{action}/{id}

Runs callback on single row. Response includes onSuccess hint for the frontend (refetchRow, refetchData, etc.).

Row bulk action

POST /api/api-table/control-tables/row-bulk-table-action/{tableName}/{action}

Requires selected_ids array (min 1). Same row action executed across selection.

Row refetch

POST /api/api-table/control-tables/row-refetch/{tableName}/{rowId}
POST /api/api-table/control-tables/multi-row-refetch/{tableName}

Returns fresh row data after mutations. Multi-refetch accepts row_ids in body.

Errors

{
  "success": false,
  "errors": ["Action is not defined", "إجراء غير معرف"]
}

On this page