Homarr
Boards

Move or resize one board item

PATCH/api/boards/{boardId}/items/{itemId}/layouts/{layoutId}

Update one item's position and size in one existing layout without replacing the board. Requires modify access. The item stays in its current section; out-of-bounds and overlapping placements are rejected.

Authorization

apikey
ApiKey<token>

API key which can be obtained in the Homarr administration dashboard

In: header

Path Parameters

boardId*string
itemId*string
layoutId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/api/boards/string/items/string/layouts/string" \  -H "Content-Type: application/json" \  -d '{    "xOffset": 0,    "yOffset": 0,    "width": 1,    "height": 1  }'
{  "boardId": "string",  "itemId": "string",  "layoutId": "string",  "xOffset": 0,  "yOffset": 0,  "width": 1,  "height": 1}

Add an item to a board

Add a widget or app to the first available position in the main canvas of each layout and return its item ID. Requires modify access to the board and use access to linked integrations. Widget configurations must be valid; placing Custom Widgets requires admin permission.

Get server information

Return the Homarr server version. Requires authentication.