Ivanti Neurons for ITSM (REST) icon

Ivanti Neurons for ITSM (REST)

Interact with Ivanti Neurons for ITSM

Actions16

Search → Simple Search

AI-generated

Summary

Perform a simple search on a specified Ivanti Neurons ITSM business object using a text query and optional parameters to filter, select fields, sort, and paginate results.

Inputs

  • Business Object Name (required) — The name of the business object to search (e.g., Incident, Change). An "s" is appended automatically to form the actual object name (e.g., Incident becomes Incidents).
  • Search Text (required) — The text string to use as the search query.
  • Return All — Whether to return all matching results or limit the number returned.
  • Limit — Maximum number of results to return when 'Return All' is false.
  • Send Select Parameters — Optionally specify which fields to include in the response.
  • Select Mode — Choose to specify fields either from a list or manually as a comma-separated string.
  • Select Names or IDs — Fields chosen from a dropdown to return in the response (when 'Select Mode' is 'From List').
  • Select (Manual) — Comma-separated list of fields to return (when 'Select Mode' is 'Manual').
  • Send Sort Parameters — Whether to sort the search results.
  • Order By Field — Field name to sort the results by.
  • Order Direction — Direction to sort the results (ascending or descending).
  • Options — Additional options including OData filters to narrow results, stripping null values from output, sorting output keys alphabetically, and pagination settings (pages per batch and interval in ms between batches).

Output shape

a list of records matching the search criteria

The returned data includes fields filtered and selected as specified, supports pagination if configured, and may remove null-valued fields or sort output keys based on options. Results respect the limit unless 'Return All' is enabled.

Examples

Example 1: Search for Incidents containing 'server error' text, returning up to 20 items, selecting the fields 'RecId' and 'Status', sorted by 'CreatedDateTime' descending.

Business Object Name: Incident
Search Text: server error
Return All: false
Limit: 20
Send Select Parameters: true
Select Mode: Manual
Select (Manual): RecId,Status
Send Sort Parameters: true
Order By Field: CreatedDateTime
Order Direction: desc

Links

Discussion