Changelog

Eagle Web API V2 changelog, documenting all notable changes.

Looking for the V1 API changelog? Visit the legacy V1 API documentation.

---

V2 API — Initial Release

The V2 API (/api/v2/...) is a comprehensive replacement for the V1 API, built on top of Eagle's Plugin API capabilities. Key features:

New Capabilities (vs V1)

• Full-text search — POST /api/v2/item/query with advanced query syntax (AND, OR, NOT, phrases)

• AI semantic search — Search by text description (searchByText), image similarity (searchByBase64, searchByItemId)

• Tag management — Create, rename, and merge tags; manage tag groups

• Folder management — Create, move, rename, and organize folders

• Automatic pagination — All list endpoints return paginated results by default (offset / limit)

• Field selection — Use the fields parameter on item list to return only needed data

Endpoints

Section	Endpoints
Item	get, query, countAll, add, save, open, select, setCustomThumbnail, refreshThumbnail
Folder	get, create, open, save
Tag	get, getRecentTags, getStarredTags, save, merge
Tag Group	get, create, save, remove, addTags, removeTags
Library	info
App	info
AI Search	isInstalled, isReady, isStarting, isSyncing, getSyncStatus, checkServiceHealth, searchByText, searchByBase64, searchByItemId

Pagination

All list endpoints use automatic pagination:

• Default limit: 50

• Maximum limit: 1000

• Response includes total, offset, and limit metadata