Homarr
Apps

List selectable apps

GET/api/apps/selectable

Return app IDs, names, icons, descriptions, destination URLs, and ping URLs for selection controls. Requires authentication.

Authorization

apikey
ApiKey<token>

API key which can be obtained in the Homarr administration dashboard

In: header

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/apps/selectable"
[  {    "id": "string",    "name": "string",    "iconUrl": "string",    "href": "string",    "pingUrl": "string",    "description": "string"  }]

Search apps

Find apps whose names contain the query, ordered by name. Requires app-modify-all or board-modify-all permission; returns up to 100 results.

Get an app

Return an app by ID. Signed-in users can access all apps; anonymous access is limited to apps placed on public boards. Missing or inaccessible apps return not found.