Widgets

Create a dashboard widget

Create a widget on a dashboard the authenticated user can write to.

Requires MEMBER role or higher in the project's workspace (the write service decides). Strict create — never idempotent, created is always true on success.

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. payload (CreateWidgetRequest): The widget to create. _live (None): Write-path liveness gate (blocks a revoked JWT session).

Returns: CreateWidgetResponse: The created widget.

post/api/v1/public/widgets

Request

  • Base URL
    https://app.traceroot.ai
  • URL
    https://app.traceroot.ai/api/v1/public/widgets
  • Auth
    HTTP bearer

Request body

dashboard_idstring required
display_configobject nullable
project_idstring required
titlestring required
typestring required

Response

Successful Response

createdboolean required
dashboard_idstring required
idstring required
titlestring required
typestring required

Changes

No recorded changes to this operation across all 1 revision of this API.