Add

[POST] .../v1/dashboard/add

Creates a dashboard. Use this method to create a user-owned dashboard before adding widgets or assigning the dashboard to users. The method requires a non-empty dashboard name up to 50 characters, accepts optional firm_id and stock_id filters, validates referenced company and stock when they are non-zero, inserts the dashboard, assigns it to the current request user, writes an action log record, clears dashboard cache and returns new_id. The request body is required; firm_id and stock_id may be 0 to leave the corresponding dashboard filter unset and stock must belong to firm when both are provided. The current implementation does not perform a separate permission check for dashboard creation and assigns the new dashboard to the current request user. Business errors such as missing body, missing or long name, missing request user context, unknown company or stock, stock-company mismatch, database errors, transaction failures and action-log failures are returned as HTTP 200 ErrorResult.

Request Parameters

Request Example

{
  "name": "Sales overview",
  "firm_id": 10,
  "stock_id": 4
}

Response Parameters

Response Example

{
  "ok": true,
  "result": {
    "new_id": 3
  }
}