Batch-update widget layout positions on a dashboard.
PUT
/dashboard/{dashboard_id}/layout
const url = 'https://api.siteqwality.com/dashboard/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/layout';const options = { method: 'PUT', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '[{"widget_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","x":1,"y":1,"w":1,"h":1}]'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://api.siteqwality.com/dashboard/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/layout \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '[ { "widget_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "x": 1, "y": 1, "w": 1, "h": 1 } ]'Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” dashboard_id
required
string format: uuid
Dashboard identifier
Request Body required
Section titled “Request Body required ” Media type application/json
Array<object>
object
widget_id
required
string format: uuid
x
required
integer format: int32
y
required
integer format: int32
w
required
integer format: int32
h
required
integer format: int32
Example generated
[ { "widget_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "x": 1, "y": 1, "w": 1, "h": 1 }]Responses
Section titled “ Responses ”Layouts updated
Too many widgets in request
Missing or invalid authentication
Internal server error