Create a dashboard
POST/dashboards
Registers a new dashboard with metadata and optional widgets. A valid role_id with dashboards.fullaccess is required. On success the creator is granted AccessType owner, and the response includes DashboardId (UUID), CustomUrlPath ({CurrentSlug}-{CustomId}, for example SalesOverview-3c4d5e6f), and a success Message. DashboardId is generated server-side when omitted from the body. This Lambda maps InvalidInputException to HTTP 422, UnauthorizedUserException (resource ACL) to HTTP 401, RequestValidationError to HTTP 400, and unhandled/GenericFailure to HTTP 500. Widgets may be omitted (defaults to an empty list). QuickSight widgets must include Configuration.QuicksightDashboardId.Value set to an existing QuickSight dashboard ID (else DASH-1007 / DASH-1006). Insights widgets validate caller access to Configuration.ResourcesList.Value entries. Not idempotent: each successful call creates a new dashboard.
Request
Responses
- 200
- 400
- 401
- 422
- 500
Dashboard created. Message is "Dashboard registration completed successfully." Body includes DashboardId and CustomUrlPath.
Response Headers
RequestValidationError (Pydantic) for body/header constraints. Body is {"Message": " -
Response Headers
Insufficient access to insights widget resources. Body is {"Message": "AUTH-1012 - ..."}.
Response Headers
InvalidInputException. Codes include AUTH-1001, AUTH-1030 (missing dashboards.fullaccess), DASH-1006/1007, IPV-1002, IPV-1045 (insights ResourcesList), and related II codes.
Response Headers
Backend/generic failure. Body is {"Message": " -