Documentation by ClonePartner

Start typing to search.

API Reference

Resolve input-widget options on a shared dashboard

View Markdown
POST /api/public/dashboards/{token}/widgets/{widgetId}/options

Mirror of POST /api/dashboards/{id}/widgets/{widgetId}/options. Gated by the kill switch (503) and allow_public_input (403).

Operation IDresolvePublicDashboardWidgetOptions

Authentication

No authentication is required.

Path parameters

tokenstringrequired
widgetIdstringrequired

Request body

Content typeapplication/json

requestobject

side selects the option source: 'source' | 'target' for a field_mapping widget, or a field key for a form widget. q is server-side search, cursor is the pagination cursor (omit for the first page). value is the current draft widget value, used by dependent form option sources.

4 properties
sidestring
qstring
cursorstring
valueunknown

Current draft value for this input widget.

Success response body

200One page of options

One page of options

Content typeapplication/json

responseobject
2 properties
optionsarray<WidgetOption>required
Array items
itemobject
3 properties
labelstringrequired
valuestringrequired
subTextstring
next_cursorstring | nullrequired
Nullable
yes

Error responses

400Validation error

Validation error

Content typeapplication/json

responseobject
2 properties
errorstring
Example
NOT_FOUND
messagestring
Example
Resource not found
Example response
{
  "error": "VALIDATION_ERROR",
  "message": "Invalid input"
}

403Public input not enabled for this dashboard

Public input not enabled for this dashboard

No response content schema is documented.

404Resource not found

Resource not found

Content typeapplication/json

responseobject
2 properties
errorstring
Example
NOT_FOUND
messagestring
Example
Resource not found
Example response
{
  "error": "NOT_FOUND",
  "message": "Resource not found"
}

503Public dashboard input disabled on this server

Public dashboard input disabled on this server

No response content schema is documented.