Add Item Search Async
POST/api/itemsearch/create
Tier: Public — stable, supported for third-party integration.
Creates a new item search from an advanced-search query and snapshots the currently matching items as its expected list.
AddItemSearchDto.OrganisationId and AddItemSearchDto.UserId are ignored
on input and overwritten server-side from the caller's JWT.
AddItemSearchDto.Query is a JSON-serialised advanced-search query, executed
immediately to build the expected item list. The new search's initial state is Created
(start/end dates unset).
Request
Responses
- 200
- 400
- 401
- 403
Returns the created search. See Items.AddItemSearchResultDto;
echoes the request plus ItemsCount — the number of items snapshotted.
The query failed to execute (e.g. malformed Query JSON) or validation failed.
Caller is not authenticated.
Caller does not have Create permission on the Item module.