dashboards

Reorder a dashboard's pages.

Sets the page order. order must list every live page exactly once (slugs or UUIDs); position becomes the list index. Concurrency is checked against the DASHBOARD version (page order is dashboard-level arrangement). Editor or above.

post/v1/dashboards/{id}/pages/reorder

Request

  • Base URL: http://localhost:8080
  • URL: http://localhost:8080/v1/dashboards/{id}/pages/reorder
  • Auth: one of:
    • API key in cookie dvt_session
    • HTTP bearer

Query parameters

reasonstring

Optional change note (the "why") recorded in version history and on the audit log entry (DVT-5309); 1–280 characters. May also be supplied via the X-Dvt-Change-Reason header. Over-cap values return 400.

Request body

orderstring[] required

Every live page, by slug or UUID, in the desired order.

versioninteger required

The dashboard's current version.

Response

The pages in their new order.

Changes

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