Dashboards

Delete a dashboard

Hard-delete a dashboard together with its widgets.

Requires MEMBER role or higher in the project's workspace (the write service decides). A project's last dashboard cannot be deleted.

Args: request (Request): Incoming request (rate-limit plumbing). response (Response): Outgoing response (rate-limit plumbing). auth (AccountStampedAuth): Account-scope user auth (session token or CLI access JWT); its resolved user_id becomes the actor. dashboard_id (str): The dashboard to delete. project_id (str): The project the dashboard belongs to. reason (str): Why it is being deleted; recorded on the audit row. _live (None): Write-path liveness gate (blocks a revoked JWT session).

Returns: DeleteDashboardResponse: The removed dashboard and its widget count.

Raises: HTTPException: The write service's 400/403/404/409 verbatim, or a 503 when its response is ambiguous.

delete/api/v1/public/dashboards/{dashboard_id}

Request

Base URL
https://app.traceroot.ai
URL
https://app.traceroot.ai/api/v1/public/dashboards/{dashboard_id}
Auth
HTTP bearer

Path parameters

dashboard_idstring required

Query parameters

project_idstring required

The project the resource belongs to

reasonstring required

Why the resource is being deleted; recorded on the audit row

Response

Successful Response

cascadedobject nullable

deletedboolean required