# ManageEngine ServiceDesk Plus (/integrations/manageengine_sdp)

Use cases and templates: [ManageEngine ServiceDesk Plus integration for AI agents](https://www.sim.ai/integrations/manageengine-servicedesk-plus)





<BlockInfoCard type="manageengine_sdp" color="#FFFFFF" />

{/* MANUAL-CONTENT-START:intro */}

Use [ManageEngine ServiceDesk Plus Cloud](https://www.manageengine.com/products/service-desk/) to manage requests, problems, changes, assets, and knowledge-base solutions through its v3 REST API. The 31 operations cover create, read, list, update, and delete across those modules, plus request, problem, and change notes.

Lookup fields such as status, priority, category, technician, group, topic, and product use names or email addresses. Custom fields use the `udf_*` keys. Use `search_criteria` for server-side filtering with text, numeric, and date comparisons; for example, sort requests by `due_by_time` to find approaching deadlines. Solutions and requester-visible notes can support ticket replies; resolved requests and notes can supply a new knowledge-base article.

## Before you start [#before-you-start]

Connect your Zoho account from the block's credential field. Self-hosted deployments additionally need Sim's Zoho OAuth client configured in the [Zoho API console](https://api-console.zoho.com/). The same client serves Zoho Desk and ServiceDesk Plus — Zoho scopes are chosen per authorization request, not per registered client, so no second app is needed.

Three things shape what will work:

* **Data center.** Connecting requires a Zoho account in the **US** data center. Sim's authorize and token-exchange legs are pinned to `accounts.zoho.com`, and a Zoho access token is only valid in the data center that issued it. The **Data Center** field lists every documented host (US, EU, IN, AU, JP, CA, SA, UK, CN, AE) because that mapping is stable, but only US is reachable with a credential connected through Sim today.
* **Portal.** Accounts with more than one portal must set the **Portal** field to the portal's URL name — found under *ESM Directory → Service Desk Instances*. Leaving it empty addresses the account's default portal.
* **Scopes.** The connection requests `SDPOnDemand.{requests,problems,changes,assets,solutions}` at the exact verbs these operations use, plus `aaaserver.profile.READ` to label the credential. Nothing broader is requested, so an operation whose module your Zoho user cannot access will fail at ServiceDesk Plus rather than being silently skipped.

## Updates and pagination [#updates-and-pagination]

* **Required fields differ per module.** Requests need a subject; problems a title; changes a title, stage, and status; assets a name and an existing product; solutions a title, content, and an existing topic.
* **Editing a change's status requires a comment.** ServiceDesk Plus rejects the update otherwise, so the **Status Comment** field sits alongside the status on Update Change.
* **Updates only send what you fill in.** Fields left empty are omitted from the request rather than sent as null, so changing a status never clears the technician or category. The two flags that cannot express this with a toggle — **Emergency Change** and **Visible to Requesters** — become *Leave unchanged / Yes / No* dropdowns on their update operations for the same reason.
* **A solution only becomes requester-visible once approved.** ServiceDesk Plus ignores `is_public` until the article's approval status is Approved.
* **Lists cap at 100 rows.** `Row Count` is clamped to the documented maximum; page with `Start Index` and watch `has_more_rows` in the returned `listInfo`. Set **Include Total Count** when you need the true size of a queue rather than the page size.
* **The standalone Tasks module is not covered.** Its endpoints are documented but the ServiceDesk Plus scope table publishes no `tasks` entry, so requesting one would put an unverified scope on the consent screen.

{/* MANUAL-CONTENT-END */}

## OAuth scopes [#oauth-scopes]

Sim requests these scopes when someone connects a ManageEngine ServiceDesk Plus account. For a self-hosted deployment, register your own app with the provider using the settings below. See [Integrations and OAuth](/platform/self-hosting/integrations-oauth) for setup.

| Setting | Value |
| - | - |
| Redirect URI | `<NEXT_PUBLIC_APP_URL>/api/auth/oauth2/callback/manageengine-sdp` |
| Environment variables | `ZOHO_CLIENT_ID`, `ZOHO_CLIENT_SECRET` |

| Scope | Description |
| - | - |
| `SDPOnDemand.requests.CREATE` | Create requests |
| `SDPOnDemand.requests.READ` | View requests and their notes |
| `SDPOnDemand.requests.UPDATE` | Update requests and add notes |
| `SDPOnDemand.requests.DELETE` | Delete requests |
| `SDPOnDemand.problems.CREATE` | Create problems |
| `SDPOnDemand.problems.READ` | View problems and their notes |
| `SDPOnDemand.problems.UPDATE` | Update problems and add notes |
| `SDPOnDemand.problems.DELETE` | Delete problems |
| `SDPOnDemand.changes.CREATE` | Create changes |
| `SDPOnDemand.changes.READ` | View changes and their notes |
| `SDPOnDemand.changes.UPDATE` | Update changes and add notes |
| `SDPOnDemand.changes.DELETE` | Delete changes |
| `SDPOnDemand.assets.CREATE` | Create assets |
| `SDPOnDemand.assets.READ` | View assets |
| `SDPOnDemand.assets.UPDATE` | Update assets |
| `SDPOnDemand.assets.DELETE` | Delete assets |
| `SDPOnDemand.solutions.CREATE` | Create knowledge base solutions |
| `SDPOnDemand.solutions.READ` | View knowledge base solutions |
| `SDPOnDemand.solutions.UPDATE` | Update knowledge base solutions |
| `SDPOnDemand.solutions.DELETE` | Delete knowledge base solutions |
| `aaaserver.profile.READ` | View your Zoho profile |

## Use the block [#usage-instructions]

Full read and write access to ManageEngine ServiceDesk Plus Cloud: create, search, update and delete requests, problems, changes, assets and knowledge base solutions, and add notes to requests, problems and changes. Supports multi-portal accounts. Connecting requires a Zoho account in the US data center.

## Actions [#actions]

### ManageEngine SDP Create Request [#manageengine-sdp-create-request]

Create a request (ticket) in ManageEngine ServiceDesk Plus Cloud with a subject, description, requester and classification.

#### Input [#input]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `subject` | string | Yes | Request subject (maximum 250 characters) |
| `description` | string | No | Request description. HTML is supported |
| `requesterEmail` | string | No | Email address of the requester. Defaults to the authenticated user |
| `priority` | string | No | Priority name, e.g. High |
| `status` | string | No | Status name, e.g. Open |
| `category` | string | No | Category name |
| `subcategory` | string | No | Subcategory name |
| `group` | string | No | Support group name |
| `technicianEmail` | string | No | Email address of the technician to assign |
| `urgency` | string | No | Urgency name |
| `impact` | string | No | Impact name |
| `requestType` | string | No | Request type name, e.g. Incident or Service Request |
| `udfFields` | json | No | Portal-defined custom fields, e.g. \{"udf\_char1":"value"} |

#### Output [#output]

| Parameter | Type | Description |
| - | - | - |
| `request` | object | The created request |
| ↳ `id` | string | Request ID |
| ↳ `display_id` | string | Request number shown in the SDP UI |
| ↳ `subject` | string | Request subject |
| ↳ `description` | string | Request description (HTML) |
| ↳ `status` | json | Current status |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `color` | string | Status colour |
| ↳ `in_progress` | boolean | Whether the status is in progress |
| ↳ `internal_name` | string | Internal status name |
| ↳ `stop_timer` | boolean | Whether the SLA timer stops |
| ↳ `priority` | json | Priority |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `color` | string | Priority colour |
| ↳ `requester` | json | Requester |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `technician` | json | Assigned technician |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `group` | json | Support group |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `site` | string | Site the group belongs to |
| ↳ `deleted` | boolean | Whether the group is deleted |
| ↳ `category` | json | Category |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `subcategory` | json | Subcategory |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `urgency` | json | Urgency |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `impact` | json | Impact |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `template` | json | Request template |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `site` | json | Site |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `created_time` | json | Creation time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `due_by_time` | json | SLA due time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `resolved_time` | json | Resolution time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `completed_time` | json | Completion time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `is_service_request` | boolean | Whether this is a service request rather than an incident |
| ↳ `has_notes` | boolean | Whether the request has notes |
| ↳ `udf_fields` | json | Portal-defined custom fields |

### ManageEngine SDP Get Request [#manageengine-sdp-get-request]

Retrieve a single ManageEngine ServiceDesk Plus Cloud request by ID.

#### Input [#input-1]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `requestId` | string | Yes | ID of the request to retrieve |

#### Output [#output-1]

| Parameter | Type | Description |
| - | - | - |
| `request` | object | The request |
| ↳ `id` | string | Request ID |
| ↳ `display_id` | string | Request number shown in the SDP UI |
| ↳ `subject` | string | Request subject |
| ↳ `description` | string | Request description (HTML) |
| ↳ `status` | json | Current status |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `color` | string | Status colour |
| ↳ `in_progress` | boolean | Whether the status is in progress |
| ↳ `internal_name` | string | Internal status name |
| ↳ `stop_timer` | boolean | Whether the SLA timer stops |
| ↳ `priority` | json | Priority |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `color` | string | Priority colour |
| ↳ `requester` | json | Requester |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `technician` | json | Assigned technician |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `group` | json | Support group |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `site` | string | Site the group belongs to |
| ↳ `deleted` | boolean | Whether the group is deleted |
| ↳ `category` | json | Category |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `subcategory` | json | Subcategory |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `urgency` | json | Urgency |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `impact` | json | Impact |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `template` | json | Request template |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `site` | json | Site |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `created_time` | json | Creation time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `due_by_time` | json | SLA due time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `resolved_time` | json | Resolution time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `completed_time` | json | Completion time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `is_service_request` | boolean | Whether this is a service request rather than an incident |
| ↳ `has_notes` | boolean | Whether the request has notes |
| ↳ `udf_fields` | json | Portal-defined custom fields |

### ManageEngine SDP List Requests [#manageengine-sdp-list-requests]

List ManageEngine ServiceDesk Plus Cloud requests, with optional search criteria, sorting and paging.

#### Input [#input-2]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `rowCount` | number | No | Rows to return (maximum 100) |
| `startIndex` | number | No | One-based index of the first row to return |
| `sortField` | string | No | Field to sort on, e.g. created\_time |
| `sortOrder` | string | No | Sort direction: asc or desc |
| `searchCriteria` | json | No | Search criteria object or array, e.g. \{"field":"status.name","condition":"is","value":"Open"} |
| `fieldsRequired` | json | No | Array of field names to return, e.g. \["subject","status"] |
| `getTotalCount` | boolean | No | Include the total matching row count in list\_info |

#### Output [#output-2]

| Parameter | Type | Description |
| - | - | - |
| `requests` | array | Matching requests |
| ↳ `id` | string | Request ID |
| ↳ `display_id` | string | Request number shown in the SDP UI |
| ↳ `subject` | string | Request subject |
| ↳ `description` | string | Request description (HTML) |
| ↳ `status` | json | Current status |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `color` | string | Status colour |
| ↳ `in_progress` | boolean | Whether the status is in progress |
| ↳ `internal_name` | string | Internal status name |
| ↳ `stop_timer` | boolean | Whether the SLA timer stops |
| ↳ `priority` | json | Priority |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `color` | string | Priority colour |
| ↳ `requester` | json | Requester |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `technician` | json | Assigned technician |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `group` | json | Support group |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `site` | string | Site the group belongs to |
| ↳ `deleted` | boolean | Whether the group is deleted |
| ↳ `category` | json | Category |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `subcategory` | json | Subcategory |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `urgency` | json | Urgency |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `impact` | json | Impact |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `template` | json | Request template |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `site` | json | Site |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `created_time` | json | Creation time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `due_by_time` | json | SLA due time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `resolved_time` | json | Resolution time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `completed_time` | json | Completion time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `is_service_request` | boolean | Whether this is a service request rather than an incident |
| ↳ `has_notes` | boolean | Whether the request has notes |
| ↳ `udf_fields` | json | Portal-defined custom fields |
| `count` | number | Number of requests returned in this page |
| `listInfo` | object | Paging metadata echoed by ServiceDesk Plus |
| ↳ `row_count` | number | Rows returned |
| ↳ `start_index` | number | Index the page started at |
| ↳ `page` | number | Page number |
| ↳ `has_more_rows` | boolean | Whether more rows are available after this page |
| ↳ `sort_field` | string | Field the results were sorted on |
| ↳ `sort_order` | string | Sort direction |
| ↳ `total_count` | number | Total matching rows, present only when get\_total\_count was requested |

### ManageEngine SDP Update Request [#manageengine-sdp-update-request]

Update a ManageEngine ServiceDesk Plus Cloud request: change its status, priority, assignment, classification or description.

#### Input [#input-3]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `requestId` | string | Yes | ID of the request to update |
| `subject` | string | No | New subject (maximum 250 characters) |
| `description` | string | No | New description. HTML is supported |
| `priority` | string | No | Priority name to set, e.g. High |
| `status` | string | No | Status name to set, e.g. Resolved |
| `category` | string | No | Category name to set |
| `subcategory` | string | No | Subcategory name to set |
| `group` | string | No | Support group name to set |
| `technicianEmail` | string | No | Email address of the technician to assign |
| `urgency` | string | No | Urgency name to set |
| `impact` | string | No | Impact name to set |
| `udfFields` | json | No | Portal-defined custom fields to set, e.g. \{"udf\_char1":"value"} |

#### Output [#output-3]

| Parameter | Type | Description |
| - | - | - |
| `request` | object | The updated request |
| ↳ `id` | string | Request ID |
| ↳ `display_id` | string | Request number shown in the SDP UI |
| ↳ `subject` | string | Request subject |
| ↳ `description` | string | Request description (HTML) |
| ↳ `status` | json | Current status |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `color` | string | Status colour |
| ↳ `in_progress` | boolean | Whether the status is in progress |
| ↳ `internal_name` | string | Internal status name |
| ↳ `stop_timer` | boolean | Whether the SLA timer stops |
| ↳ `priority` | json | Priority |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `color` | string | Priority colour |
| ↳ `requester` | json | Requester |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `technician` | json | Assigned technician |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `group` | json | Support group |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `site` | string | Site the group belongs to |
| ↳ `deleted` | boolean | Whether the group is deleted |
| ↳ `category` | json | Category |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `subcategory` | json | Subcategory |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `urgency` | json | Urgency |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `impact` | json | Impact |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `template` | json | Request template |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `site` | json | Site |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `created_time` | json | Creation time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `due_by_time` | json | SLA due time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `resolved_time` | json | Resolution time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `completed_time` | json | Completion time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `is_service_request` | boolean | Whether this is a service request rather than an incident |
| ↳ `has_notes` | boolean | Whether the request has notes |
| ↳ `udf_fields` | json | Portal-defined custom fields |

### ManageEngine SDP Delete Request [#manageengine-sdp-delete-request]

Move a ManageEngine ServiceDesk Plus Cloud request to the trash. Deleting a request also removes its notes, tasks and worklogs.

#### Input [#input-4]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `requestId` | string | Yes | ID of the request to delete |

#### Output [#output-4]

| Parameter | Type | Description |
| - | - | - |
| `deleted` | boolean | Whether the request was deleted |

### ManageEngine SDP Add Request Note [#manageengine-sdp-add-request-note]

Add a note to a ManageEngine ServiceDesk Plus Cloud request, optionally making it visible to the requester.

#### Input [#input-5]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `requestId` | string | Yes | ID of the request to add the note to |
| `description` | string | Yes | Note body. HTML is supported |
| `showToRequester` | boolean | No | Whether the requester can see this note |
| `notifyTechnician` | boolean | No | Whether to notify the assigned technician |
| `markFirstResponse` | boolean | No | Whether this note counts as the first response for SLA purposes |
| `addToLinkedRequests` | boolean | No | Whether to copy the note to linked requests |

#### Output [#output-5]

| Parameter | Type | Description |
| - | - | - |
| `note` | object | The created note |
| ↳ `id` | string | Note ID |
| ↳ `description` | string | Note body (HTML) |
| ↳ `show_to_requester` | boolean | Whether the note is visible to the requester |
| ↳ `notify_technician` | boolean | Whether the technician was notified |
| ↳ `mark_first_response` | boolean | Whether the note counts as the first response |
| ↳ `add_to_linked_requests` | boolean | Whether the note was copied to linked requests |
| ↳ `created_time` | json | Creation time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `created_by` | json | Note author |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `request` | json | The request the note belongs to |
| ↳ `id` | string | Request ID |
| ↳ `display_id` | string | Request number |
| ↳ `subject` | string | Request subject |

### ManageEngine SDP List Request Notes [#manageengine-sdp-list-request-notes]

List the notes on a ManageEngine ServiceDesk Plus Cloud request.

#### Input [#input-6]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `requestId` | string | Yes | ID of the request whose notes to list |
| `rowCount` | number | No | Rows to return (maximum 100) |
| `startIndex` | number | No | One-based index of the first row to return |
| `sortField` | string | No | Field to sort on, e.g. created\_time |
| `sortOrder` | string | No | Sort direction: asc or desc |
| `searchCriteria` | json | No | Search criteria object or array, e.g. \{"field":"status.name","condition":"is","value":"Open"} |
| `fieldsRequired` | json | No | Array of field names to return, e.g. \["subject","status"] |
| `getTotalCount` | boolean | No | Include the total matching row count in list\_info |

#### Output [#output-6]

| Parameter | Type | Description |
| - | - | - |
| `notes` | array | Notes on the request |
| ↳ `id` | string | Note ID |
| ↳ `description` | string | Note body (HTML) |
| ↳ `show_to_requester` | boolean | Whether the note is visible to the requester |
| ↳ `notify_technician` | boolean | Whether the technician was notified |
| ↳ `mark_first_response` | boolean | Whether the note counts as the first response |
| ↳ `add_to_linked_requests` | boolean | Whether the note was copied to linked requests |
| ↳ `created_time` | json | Creation time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `created_by` | json | Note author |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `request` | json | The request the note belongs to |
| ↳ `id` | string | Request ID |
| ↳ `display_id` | string | Request number |
| ↳ `subject` | string | Request subject |
| `count` | number | Number of notes returned in this page |
| `listInfo` | object | Paging metadata echoed by ServiceDesk Plus |
| ↳ `row_count` | number | Rows returned |
| ↳ `start_index` | number | Index the page started at |
| ↳ `page` | number | Page number |
| ↳ `has_more_rows` | boolean | Whether more rows are available after this page |
| ↳ `sort_field` | string | Field the results were sorted on |
| ↳ `sort_order` | string | Sort direction |
| ↳ `total_count` | number | Total matching rows, present only when get\_total\_count was requested |

### ManageEngine SDP Create Problem [#manageengine-sdp-create-problem]

Create a problem record in ManageEngine ServiceDesk Plus Cloud with a title, description and classification.

#### Input [#input-7]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `title` | string | Yes | Problem title |
| `description` | string | No | Problem description. HTML is supported |
| `reportedByEmail` | string | No | Email address of the user reporting the problem |
| `technicianEmail` | string | No | Email address of the technician to assign |
| `priority` | string | No | Priority name, e.g. High |
| `status` | string | No | Status name, e.g. Open |
| `urgency` | string | No | Urgency name |
| `impact` | string | No | Impact name |
| `category` | string | No | Category name |
| `subcategory` | string | No | Subcategory name |
| `group` | string | No | Support group name |
| `site` | string | No | Site name |
| `udfFields` | json | No | Portal-defined custom fields, e.g. \{"udf\_char1":"value"} |

#### Output [#output-7]

| Parameter | Type | Description |
| - | - | - |
| `problem` | object | The created problem |
| ↳ `id` | string | Problem ID |
| ↳ `display_id` | json | Problem number shown in the SDP UI (display\_value, value) |
| ↳ `display_value` | string | Record number as shown in the UI, e.g. PB-140 |
| ↳ `value` | string | Bare sequence number, e.g. 140 |
| ↳ `title` | string | Problem title |
| ↳ `description` | string | Problem description (HTML) |
| ↳ `status` | json | Current status |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `priority` | json | Priority |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `urgency` | json | Urgency |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `impact` | json | Impact |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `category` | json | Category |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `subcategory` | json | Subcategory |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `group` | json | Support group |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `site` | json | Site |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `reported_by` | json | User who reported the problem |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `technician` | json | Assigned technician |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `reported_time` | json | Time the problem was reported |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `due_by_time` | json | Due time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `closed_time` | json | Time the problem was closed |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `root_cause` | json | Root cause analysis |
| ↳ `workaround_details` | json | Documented workaround |
| ↳ `resolution_details` | json | Documented resolution |
| ↳ `known_error_details` | json | Known-error record details |
| ↳ `notes_present` | boolean | Whether the problem has notes |

### ManageEngine SDP Get Problem [#manageengine-sdp-get-problem]

Retrieve a single ManageEngine ServiceDesk Plus Cloud problem by ID.

#### Input [#input-8]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `problemId` | string | Yes | ID of the problem to retrieve |

#### Output [#output-8]

| Parameter | Type | Description |
| - | - | - |
| `problem` | object | The problem |
| ↳ `id` | string | Problem ID |
| ↳ `display_id` | json | Problem number shown in the SDP UI (display\_value, value) |
| ↳ `display_value` | string | Record number as shown in the UI, e.g. PB-140 |
| ↳ `value` | string | Bare sequence number, e.g. 140 |
| ↳ `title` | string | Problem title |
| ↳ `description` | string | Problem description (HTML) |
| ↳ `status` | json | Current status |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `priority` | json | Priority |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `urgency` | json | Urgency |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `impact` | json | Impact |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `category` | json | Category |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `subcategory` | json | Subcategory |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `group` | json | Support group |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `site` | json | Site |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `reported_by` | json | User who reported the problem |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `technician` | json | Assigned technician |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `reported_time` | json | Time the problem was reported |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `due_by_time` | json | Due time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `closed_time` | json | Time the problem was closed |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `root_cause` | json | Root cause analysis |
| ↳ `workaround_details` | json | Documented workaround |
| ↳ `resolution_details` | json | Documented resolution |
| ↳ `known_error_details` | json | Known-error record details |
| ↳ `notes_present` | boolean | Whether the problem has notes |

### ManageEngine SDP List Problems [#manageengine-sdp-list-problems]

List ManageEngine ServiceDesk Plus Cloud problems, with optional search criteria, sorting and paging.

#### Input [#input-9]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `rowCount` | number | No | Rows to return (maximum 100) |
| `startIndex` | number | No | One-based index of the first row to return |
| `sortField` | string | No | Field to sort on, e.g. created\_time |
| `sortOrder` | string | No | Sort direction: asc or desc |
| `searchCriteria` | json | No | Search criteria object or array, e.g. \{"field":"status.name","condition":"is","value":"Open"} |
| `fieldsRequired` | json | No | Array of field names to return, e.g. \["subject","status"] |
| `getTotalCount` | boolean | No | Include the total matching row count in list\_info |

#### Output [#output-9]

| Parameter | Type | Description |
| - | - | - |
| `problems` | array | Matching problems |
| ↳ `id` | string | Problem ID |
| ↳ `display_id` | json | Problem number shown in the SDP UI (display\_value, value) |
| ↳ `display_value` | string | Record number as shown in the UI, e.g. PB-140 |
| ↳ `value` | string | Bare sequence number, e.g. 140 |
| ↳ `title` | string | Problem title |
| ↳ `description` | string | Problem description (HTML) |
| ↳ `status` | json | Current status |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `priority` | json | Priority |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `urgency` | json | Urgency |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `impact` | json | Impact |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `category` | json | Category |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `subcategory` | json | Subcategory |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `group` | json | Support group |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `site` | json | Site |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `reported_by` | json | User who reported the problem |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `technician` | json | Assigned technician |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `reported_time` | json | Time the problem was reported |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `due_by_time` | json | Due time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `closed_time` | json | Time the problem was closed |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `root_cause` | json | Root cause analysis |
| ↳ `workaround_details` | json | Documented workaround |
| ↳ `resolution_details` | json | Documented resolution |
| ↳ `known_error_details` | json | Known-error record details |
| ↳ `notes_present` | boolean | Whether the problem has notes |
| `count` | number | Number of problems returned in this page |
| `listInfo` | object | Paging metadata echoed by ServiceDesk Plus |
| ↳ `row_count` | number | Rows returned |
| ↳ `start_index` | number | Index the page started at |
| ↳ `page` | number | Page number |
| ↳ `has_more_rows` | boolean | Whether more rows are available after this page |
| ↳ `sort_field` | string | Field the results were sorted on |
| ↳ `sort_order` | string | Sort direction |
| ↳ `total_count` | number | Total matching rows, present only when get\_total\_count was requested |

### ManageEngine SDP Update Problem [#manageengine-sdp-update-problem]

Update a ManageEngine ServiceDesk Plus Cloud problem: change its title, status, assignment or classification.

#### Input [#input-10]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `problemId` | string | Yes | ID of the problem to update |
| `title` | string | No | New problem title |
| `description` | string | No | Problem description. HTML is supported |
| `reportedByEmail` | string | No | Email address of the user reporting the problem |
| `technicianEmail` | string | No | Email address of the technician to assign |
| `priority` | string | No | Priority name, e.g. High |
| `status` | string | No | Status name, e.g. Open |
| `urgency` | string | No | Urgency name |
| `impact` | string | No | Impact name |
| `category` | string | No | Category name |
| `subcategory` | string | No | Subcategory name |
| `group` | string | No | Support group name |
| `site` | string | No | Site name |
| `udfFields` | json | No | Portal-defined custom fields, e.g. \{"udf\_char1":"value"} |

#### Output [#output-10]

| Parameter | Type | Description |
| - | - | - |
| `problem` | object | The updated problem |
| ↳ `id` | string | Problem ID |
| ↳ `display_id` | json | Problem number shown in the SDP UI (display\_value, value) |
| ↳ `display_value` | string | Record number as shown in the UI, e.g. PB-140 |
| ↳ `value` | string | Bare sequence number, e.g. 140 |
| ↳ `title` | string | Problem title |
| ↳ `description` | string | Problem description (HTML) |
| ↳ `status` | json | Current status |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `priority` | json | Priority |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `urgency` | json | Urgency |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `impact` | json | Impact |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `category` | json | Category |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `subcategory` | json | Subcategory |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `group` | json | Support group |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `site` | json | Site |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `reported_by` | json | User who reported the problem |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `technician` | json | Assigned technician |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `reported_time` | json | Time the problem was reported |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `due_by_time` | json | Due time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `closed_time` | json | Time the problem was closed |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `root_cause` | json | Root cause analysis |
| ↳ `workaround_details` | json | Documented workaround |
| ↳ `resolution_details` | json | Documented resolution |
| ↳ `known_error_details` | json | Known-error record details |
| ↳ `notes_present` | boolean | Whether the problem has notes |

### ManageEngine SDP Delete Problem [#manageengine-sdp-delete-problem]

Delete a ManageEngine ServiceDesk Plus Cloud problem and its associated notes.

#### Input [#input-11]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `problemId` | string | Yes | ID of the problem to delete |

#### Output [#output-11]

| Parameter | Type | Description |
| - | - | - |
| `deleted` | boolean | Whether the problem was deleted |

### ManageEngine SDP Add Problem Note [#manageengine-sdp-add-problem-note]

Add a note to a ManageEngine ServiceDesk Plus Cloud problem.

#### Input [#input-12]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `problemId` | string | Yes | ID of the problem to add the note to |
| `description` | string | Yes | Note body. HTML is supported |

#### Output [#output-12]

| Parameter | Type | Description |
| - | - | - |
| `note` | object | The created note |
| ↳ `id` | string | Note ID |
| ↳ `description` | string | Note body (HTML) |
| ↳ `performed_by` | json | Note author |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `performed_time` | json | Time the note was added |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |

### ManageEngine SDP List Problem Notes [#manageengine-sdp-list-problem-notes]

List the notes on a ManageEngine ServiceDesk Plus Cloud problem.

#### Input [#input-13]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `problemId` | string | Yes | ID of the problem whose notes to list |
| `rowCount` | number | No | Rows to return (maximum 100) |
| `startIndex` | number | No | One-based index of the first row to return |
| `sortField` | string | No | Field to sort on, e.g. created\_time |
| `sortOrder` | string | No | Sort direction: asc or desc |
| `searchCriteria` | json | No | Search criteria object or array, e.g. \{"field":"status.name","condition":"is","value":"Open"} |
| `fieldsRequired` | json | No | Array of field names to return, e.g. \["subject","status"] |
| `getTotalCount` | boolean | No | Include the total matching row count in list\_info |

#### Output [#output-13]

| Parameter | Type | Description |
| - | - | - |
| `notes` | array | Notes on the problem |
| ↳ `id` | string | Note ID |
| ↳ `description` | string | Note body (HTML) |
| ↳ `performed_by` | json | Note author |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `performed_time` | json | Time the note was added |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| `count` | number | Number of notes returned in this page |
| `listInfo` | object | Paging metadata echoed by ServiceDesk Plus |
| ↳ `row_count` | number | Rows returned |
| ↳ `start_index` | number | Index the page started at |
| ↳ `page` | number | Page number |
| ↳ `has_more_rows` | boolean | Whether more rows are available after this page |
| ↳ `sort_field` | string | Field the results were sorted on |
| ↳ `sort_order` | string | Sort direction |
| ↳ `total_count` | number | Total matching rows, present only when get\_total\_count was requested |

### ManageEngine SDP Create Change [#manageengine-sdp-create-change]

Create a change record in ManageEngine ServiceDesk Plus Cloud with a title, stage, status and schedule.

#### Input [#input-14]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `title` | string | Yes | Change title |
| `stage` | string | Yes | Change stage name, e.g. Submission |
| `status` | string | Yes | Change status name, e.g. Open |
| `description` | string | No | Change description. HTML is supported |
| `changeTypeName` | string | No | Change type name, e.g. Standard |
| `reasonForChange` | string | No | Reason-for-change name |
| `priority` | string | No | Priority name |
| `urgency` | string | No | Urgency name |
| `impact` | string | No | Impact name |
| `group` | string | No | Support group name |
| `changeRequesterEmail` | string | No | Email address of the change requester |
| `changeOwnerEmail` | string | No | Email address of the change owner |
| `changeManagerEmail` | string | No | Email address of the change manager |
| `scheduledStartTime` | string | No | Scheduled start, as an ISO 8601 timestamp or epoch milliseconds |
| `scheduledEndTime` | string | No | Scheduled end, as an ISO 8601 timestamp or epoch milliseconds |
| `emergency` | boolean | No | Whether this is an emergency change |
| `comment` | string | No | Reason for the status update. ServiceDesk Plus requires this when status changes |
| `udfFields` | json | No | Portal-defined custom fields, e.g. \{"udf\_char1":"value"} |

#### Output [#output-14]

| Parameter | Type | Description |
| - | - | - |
| `change` | object | The created change |
| ↳ `id` | string | Change ID |
| ↳ `display_id` | json | Change number shown in the SDP UI (display\_value, value) |
| ↳ `display_value` | string | Record number as shown in the UI, e.g. PB-140 |
| ↳ `value` | string | Bare sequence number, e.g. 140 |
| ↳ `title` | string | Change title |
| ↳ `description` | string | Change description (HTML) |
| ↳ `status` | json | Current status |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `internal_name` | string | Internal status name |
| ↳ `stage` | json | Change stage |
| ↳ `change_type` | json | Change type |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `color` | string | Type colour |
| ↳ `pre_approved` | boolean | Whether the type is pre-approved |
| ↳ `priority` | json | Priority |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `urgency` | json | Urgency |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `impact` | json | Impact |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `approval_status` | json | Approval status |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `reason_for_change` | json | Reason for the change |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `change_requester` | json | User who requested the change |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `change_owner` | json | Change owner |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `change_manager` | json | Change manager |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `group` | json | Support group |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `emergency` | boolean | Whether the change is an emergency |
| ↳ `created_time` | json | Creation time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `scheduled_start_time` | json | Scheduled start |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `scheduled_end_time` | json | Scheduled end |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `roll_out_plan` | json | Roll-out plan |
| ↳ `close_details` | json | Closure details |

### ManageEngine SDP Get Change [#manageengine-sdp-get-change]

Retrieve a single ManageEngine ServiceDesk Plus Cloud change by ID.

#### Input [#input-15]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `changeId` | string | Yes | ID of the change to retrieve |

#### Output [#output-15]

| Parameter | Type | Description |
| - | - | - |
| `change` | object | The change |
| ↳ `id` | string | Change ID |
| ↳ `display_id` | json | Change number shown in the SDP UI (display\_value, value) |
| ↳ `display_value` | string | Record number as shown in the UI, e.g. PB-140 |
| ↳ `value` | string | Bare sequence number, e.g. 140 |
| ↳ `title` | string | Change title |
| ↳ `description` | string | Change description (HTML) |
| ↳ `status` | json | Current status |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `internal_name` | string | Internal status name |
| ↳ `stage` | json | Change stage |
| ↳ `change_type` | json | Change type |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `color` | string | Type colour |
| ↳ `pre_approved` | boolean | Whether the type is pre-approved |
| ↳ `priority` | json | Priority |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `urgency` | json | Urgency |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `impact` | json | Impact |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `approval_status` | json | Approval status |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `reason_for_change` | json | Reason for the change |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `change_requester` | json | User who requested the change |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `change_owner` | json | Change owner |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `change_manager` | json | Change manager |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `group` | json | Support group |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `emergency` | boolean | Whether the change is an emergency |
| ↳ `created_time` | json | Creation time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `scheduled_start_time` | json | Scheduled start |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `scheduled_end_time` | json | Scheduled end |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `roll_out_plan` | json | Roll-out plan |
| ↳ `close_details` | json | Closure details |

### ManageEngine SDP List Changes [#manageengine-sdp-list-changes]

List ManageEngine ServiceDesk Plus Cloud changes, with optional search criteria, sorting and paging.

#### Input [#input-16]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `rowCount` | number | No | Rows to return (maximum 100) |
| `startIndex` | number | No | One-based index of the first row to return |
| `sortField` | string | No | Field to sort on, e.g. created\_time |
| `sortOrder` | string | No | Sort direction: asc or desc |
| `searchCriteria` | json | No | Search criteria object or array, e.g. \{"field":"status.name","condition":"is","value":"Open"} |
| `fieldsRequired` | json | No | Array of field names to return, e.g. \["subject","status"] |
| `getTotalCount` | boolean | No | Include the total matching row count in list\_info |

#### Output [#output-16]

| Parameter | Type | Description |
| - | - | - |
| `changes` | array | Matching changes |
| ↳ `id` | string | Change ID |
| ↳ `display_id` | json | Change number shown in the SDP UI (display\_value, value) |
| ↳ `display_value` | string | Record number as shown in the UI, e.g. PB-140 |
| ↳ `value` | string | Bare sequence number, e.g. 140 |
| ↳ `title` | string | Change title |
| ↳ `description` | string | Change description (HTML) |
| ↳ `status` | json | Current status |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `internal_name` | string | Internal status name |
| ↳ `stage` | json | Change stage |
| ↳ `change_type` | json | Change type |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `color` | string | Type colour |
| ↳ `pre_approved` | boolean | Whether the type is pre-approved |
| ↳ `priority` | json | Priority |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `urgency` | json | Urgency |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `impact` | json | Impact |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `approval_status` | json | Approval status |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `reason_for_change` | json | Reason for the change |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `change_requester` | json | User who requested the change |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `change_owner` | json | Change owner |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `change_manager` | json | Change manager |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `group` | json | Support group |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `emergency` | boolean | Whether the change is an emergency |
| ↳ `created_time` | json | Creation time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `scheduled_start_time` | json | Scheduled start |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `scheduled_end_time` | json | Scheduled end |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `roll_out_plan` | json | Roll-out plan |
| ↳ `close_details` | json | Closure details |
| `count` | number | Number of changes returned in this page |
| `listInfo` | object | Paging metadata echoed by ServiceDesk Plus |
| ↳ `row_count` | number | Rows returned |
| ↳ `start_index` | number | Index the page started at |
| ↳ `page` | number | Page number |
| ↳ `has_more_rows` | boolean | Whether more rows are available after this page |
| ↳ `sort_field` | string | Field the results were sorted on |
| ↳ `sort_order` | string | Sort direction |
| ↳ `total_count` | number | Total matching rows, present only when get\_total\_count was requested |

### ManageEngine SDP Update Change [#manageengine-sdp-update-change]

Update a ManageEngine ServiceDesk Plus Cloud change: move its stage or status, reschedule it, or change its assignment. ServiceDesk Plus requires a comment whenever the status changes.

#### Input [#input-17]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `changeId` | string | Yes | ID of the change to update |
| `title` | string | No | New change title |
| `stage` | string | No | Change stage name to set |
| `status` | string | No | Change status name to set. Requires a comment |
| `description` | string | No | Change description. HTML is supported |
| `changeTypeName` | string | No | Change type name, e.g. Standard |
| `reasonForChange` | string | No | Reason-for-change name |
| `priority` | string | No | Priority name |
| `urgency` | string | No | Urgency name |
| `impact` | string | No | Impact name |
| `group` | string | No | Support group name |
| `changeRequesterEmail` | string | No | Email address of the change requester |
| `changeOwnerEmail` | string | No | Email address of the change owner |
| `changeManagerEmail` | string | No | Email address of the change manager |
| `scheduledStartTime` | string | No | Scheduled start, as an ISO 8601 timestamp or epoch milliseconds |
| `scheduledEndTime` | string | No | Scheduled end, as an ISO 8601 timestamp or epoch milliseconds |
| `emergency` | boolean | No | Whether this is an emergency change |
| `comment` | string | No | Reason for the status update. ServiceDesk Plus requires this when status changes |
| `udfFields` | json | No | Portal-defined custom fields, e.g. \{"udf\_char1":"value"} |

#### Output [#output-17]

| Parameter | Type | Description |
| - | - | - |
| `change` | object | The updated change |
| ↳ `id` | string | Change ID |
| ↳ `display_id` | json | Change number shown in the SDP UI (display\_value, value) |
| ↳ `display_value` | string | Record number as shown in the UI, e.g. PB-140 |
| ↳ `value` | string | Bare sequence number, e.g. 140 |
| ↳ `title` | string | Change title |
| ↳ `description` | string | Change description (HTML) |
| ↳ `status` | json | Current status |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `internal_name` | string | Internal status name |
| ↳ `stage` | json | Change stage |
| ↳ `change_type` | json | Change type |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `color` | string | Type colour |
| ↳ `pre_approved` | boolean | Whether the type is pre-approved |
| ↳ `priority` | json | Priority |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `urgency` | json | Urgency |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `impact` | json | Impact |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `approval_status` | json | Approval status |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `reason_for_change` | json | Reason for the change |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `change_requester` | json | User who requested the change |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `change_owner` | json | Change owner |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `change_manager` | json | Change manager |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `group` | json | Support group |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `emergency` | boolean | Whether the change is an emergency |
| ↳ `created_time` | json | Creation time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `scheduled_start_time` | json | Scheduled start |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `scheduled_end_time` | json | Scheduled end |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `roll_out_plan` | json | Roll-out plan |
| ↳ `close_details` | json | Closure details |

### ManageEngine SDP Delete Change [#manageengine-sdp-delete-change]

Delete a ManageEngine ServiceDesk Plus Cloud change and its associated notes.

#### Input [#input-18]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `changeId` | string | Yes | ID of the change to delete |

#### Output [#output-18]

| Parameter | Type | Description |
| - | - | - |
| `deleted` | boolean | Whether the change was deleted |

### ManageEngine SDP Add Change Note [#manageengine-sdp-add-change-note]

Add a note to a ManageEngine ServiceDesk Plus Cloud change.

#### Input [#input-19]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `changeId` | string | Yes | ID of the change to add the note to |
| `description` | string | Yes | Note body. HTML is supported |

#### Output [#output-19]

| Parameter | Type | Description |
| - | - | - |
| `note` | object | The created note |
| ↳ `id` | string | Note ID |
| ↳ `description` | string | Note body (HTML) |
| ↳ `performed_by` | json | Note author |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `performed_time` | json | Time the note was added |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |

### ManageEngine SDP List Change Notes [#manageengine-sdp-list-change-notes]

List the notes on a ManageEngine ServiceDesk Plus Cloud change.

#### Input [#input-20]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `changeId` | string | Yes | ID of the change whose notes to list |
| `rowCount` | number | No | Rows to return (maximum 100) |
| `startIndex` | number | No | One-based index of the first row to return |
| `sortField` | string | No | Field to sort on, e.g. created\_time |
| `sortOrder` | string | No | Sort direction: asc or desc |
| `searchCriteria` | json | No | Search criteria object or array, e.g. \{"field":"status.name","condition":"is","value":"Open"} |
| `fieldsRequired` | json | No | Array of field names to return, e.g. \["subject","status"] |
| `getTotalCount` | boolean | No | Include the total matching row count in list\_info |

#### Output [#output-20]

| Parameter | Type | Description |
| - | - | - |
| `notes` | array | Notes on the change |
| ↳ `id` | string | Note ID |
| ↳ `description` | string | Note body (HTML) |
| ↳ `performed_by` | json | Note author |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `performed_time` | json | Time the note was added |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| `count` | number | Number of notes returned in this page |
| `listInfo` | object | Paging metadata echoed by ServiceDesk Plus |
| ↳ `row_count` | number | Rows returned |
| ↳ `start_index` | number | Index the page started at |
| ↳ `page` | number | Page number |
| ↳ `has_more_rows` | boolean | Whether more rows are available after this page |
| ↳ `sort_field` | string | Field the results were sorted on |
| ↳ `sort_order` | string | Sort direction |
| ↳ `total_count` | number | Total matching rows, present only when get\_total\_count was requested |

### ManageEngine SDP Create Asset [#manageengine-sdp-create-asset]

Create an asset in the ManageEngine ServiceDesk Plus Cloud inventory. Requires a name and an existing product.

#### Input [#input-21]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `name` | string | Yes | Asset name |
| `product` | string | Yes | Name of an existing product this asset is an instance of |
| `productType` | string | No | Product type name, e.g. Laptop |
| `assetTag` | string | No | Asset tag |
| `serialNumber` | string | No | Serial number |
| `barcode` | string | No | Barcode |
| `ipAddress` | string | No | IP address |
| `macAddress` | string | No | MAC address |
| `location` | string | No | Location |
| `state` | string | No | Asset state name, e.g. In Use |
| `vendor` | string | No | Vendor name |
| `department` | string | No | Department name |
| `site` | string | No | Site name |
| `userEmail` | string | No | Email address of the user the asset is assigned to |
| `stateHistoryComments` | string | No | Comment recorded against a state change |
| `udfFields` | json | No | Portal-defined custom fields, e.g. \{"udf\_char1":"value"} |

#### Output [#output-21]

| Parameter | Type | Description |
| - | - | - |
| `asset` | object | The created asset |
| ↳ `id` | string | Asset ID |
| ↳ `name` | string | Asset name |
| ↳ `asset_tag` | string | Asset tag |
| ↳ `barcode` | string | Barcode |
| ↳ `serial_number` | string | Serial number |
| ↳ `ip_address` | string | IP address |
| ↳ `mac_address` | string | MAC address |
| ↳ `location` | string | Location |
| ↳ `state` | json | Asset state (In Use, In Store, ...) |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `description` | string | State description |
| ↳ `product` | json | Product this asset is an instance of |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `manufacturer` | string | Manufacturer |
| ↳ `part_no` | string | Part number |
| ↳ `product_type` | json | Product type |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `vendor` | json | Vendor |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `department` | json | Owning department |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `site` | json | Site |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `user` | json | User the asset is assigned to |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `purchase_cost` | number | Purchase cost |
| ↳ `total_cost` | number | Total cost |
| ↳ `acquisition_date` | json | Acquisition date |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `expiry_date` | json | Expiry date |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `warranty_expiry` | json | Warranty expiry date |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `is_loaned` | boolean | Whether the asset is on loan |
| ↳ `is_in_contract` | boolean | Whether the asset is covered by a contract |

### ManageEngine SDP Get Asset [#manageengine-sdp-get-asset]

Retrieve a single ManageEngine ServiceDesk Plus Cloud asset by ID.

#### Input [#input-22]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `assetId` | string | Yes | ID of the asset to retrieve |

#### Output [#output-22]

| Parameter | Type | Description |
| - | - | - |
| `asset` | object | The asset |
| ↳ `id` | string | Asset ID |
| ↳ `name` | string | Asset name |
| ↳ `asset_tag` | string | Asset tag |
| ↳ `barcode` | string | Barcode |
| ↳ `serial_number` | string | Serial number |
| ↳ `ip_address` | string | IP address |
| ↳ `mac_address` | string | MAC address |
| ↳ `location` | string | Location |
| ↳ `state` | json | Asset state (In Use, In Store, ...) |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `description` | string | State description |
| ↳ `product` | json | Product this asset is an instance of |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `manufacturer` | string | Manufacturer |
| ↳ `part_no` | string | Part number |
| ↳ `product_type` | json | Product type |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `vendor` | json | Vendor |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `department` | json | Owning department |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `site` | json | Site |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `user` | json | User the asset is assigned to |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `purchase_cost` | number | Purchase cost |
| ↳ `total_cost` | number | Total cost |
| ↳ `acquisition_date` | json | Acquisition date |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `expiry_date` | json | Expiry date |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `warranty_expiry` | json | Warranty expiry date |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `is_loaned` | boolean | Whether the asset is on loan |
| ↳ `is_in_contract` | boolean | Whether the asset is covered by a contract |

### ManageEngine SDP List Assets [#manageengine-sdp-list-assets]

List ManageEngine ServiceDesk Plus Cloud assets, with optional search criteria, sorting and paging.

#### Input [#input-23]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `rowCount` | number | No | Rows to return (maximum 100) |
| `startIndex` | number | No | One-based index of the first row to return |
| `sortField` | string | No | Field to sort on, e.g. created\_time |
| `sortOrder` | string | No | Sort direction: asc or desc |
| `searchCriteria` | json | No | Search criteria object or array, e.g. \{"field":"status.name","condition":"is","value":"Open"} |
| `fieldsRequired` | json | No | Array of field names to return, e.g. \["subject","status"] |
| `getTotalCount` | boolean | No | Include the total matching row count in list\_info |

#### Output [#output-23]

| Parameter | Type | Description |
| - | - | - |
| `assets` | array | Matching assets |
| ↳ `id` | string | Asset ID |
| ↳ `name` | string | Asset name |
| ↳ `asset_tag` | string | Asset tag |
| ↳ `barcode` | string | Barcode |
| ↳ `serial_number` | string | Serial number |
| ↳ `ip_address` | string | IP address |
| ↳ `mac_address` | string | MAC address |
| ↳ `location` | string | Location |
| ↳ `state` | json | Asset state (In Use, In Store, ...) |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `description` | string | State description |
| ↳ `product` | json | Product this asset is an instance of |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `manufacturer` | string | Manufacturer |
| ↳ `part_no` | string | Part number |
| ↳ `product_type` | json | Product type |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `vendor` | json | Vendor |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `department` | json | Owning department |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `site` | json | Site |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `user` | json | User the asset is assigned to |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `purchase_cost` | number | Purchase cost |
| ↳ `total_cost` | number | Total cost |
| ↳ `acquisition_date` | json | Acquisition date |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `expiry_date` | json | Expiry date |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `warranty_expiry` | json | Warranty expiry date |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `is_loaned` | boolean | Whether the asset is on loan |
| ↳ `is_in_contract` | boolean | Whether the asset is covered by a contract |
| `count` | number | Number of assets returned in this page |
| `listInfo` | object | Paging metadata echoed by ServiceDesk Plus |
| ↳ `row_count` | number | Rows returned |
| ↳ `start_index` | number | Index the page started at |
| ↳ `page` | number | Page number |
| ↳ `has_more_rows` | boolean | Whether more rows are available after this page |
| ↳ `sort_field` | string | Field the results were sorted on |
| ↳ `sort_order` | string | Sort direction |
| ↳ `total_count` | number | Total matching rows, present only when get\_total\_count was requested |

### ManageEngine SDP Update Asset [#manageengine-sdp-update-asset]

Update a ManageEngine ServiceDesk Plus Cloud asset: reassign it, change its state, or correct its inventory details.

#### Input [#input-24]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `assetId` | string | Yes | ID of the asset to update |
| `name` | string | No | New asset name |
| `product` | string | No | Name of an existing product to reassign the asset to |
| `productType` | string | No | Product type name, e.g. Laptop |
| `assetTag` | string | No | Asset tag |
| `serialNumber` | string | No | Serial number |
| `barcode` | string | No | Barcode |
| `ipAddress` | string | No | IP address |
| `macAddress` | string | No | MAC address |
| `location` | string | No | Location |
| `state` | string | No | Asset state name, e.g. In Use |
| `vendor` | string | No | Vendor name |
| `department` | string | No | Department name |
| `site` | string | No | Site name |
| `userEmail` | string | No | Email address of the user the asset is assigned to |
| `stateHistoryComments` | string | No | Comment recorded against a state change |
| `udfFields` | json | No | Portal-defined custom fields, e.g. \{"udf\_char1":"value"} |

#### Output [#output-24]

| Parameter | Type | Description |
| - | - | - |
| `asset` | object | The updated asset |
| ↳ `id` | string | Asset ID |
| ↳ `name` | string | Asset name |
| ↳ `asset_tag` | string | Asset tag |
| ↳ `barcode` | string | Barcode |
| ↳ `serial_number` | string | Serial number |
| ↳ `ip_address` | string | IP address |
| ↳ `mac_address` | string | MAC address |
| ↳ `location` | string | Location |
| ↳ `state` | json | Asset state (In Use, In Store, ...) |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `description` | string | State description |
| ↳ `product` | json | Product this asset is an instance of |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `manufacturer` | string | Manufacturer |
| ↳ `part_no` | string | Part number |
| ↳ `product_type` | json | Product type |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `vendor` | json | Vendor |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `department` | json | Owning department |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `site` | json | Site |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `user` | json | User the asset is assigned to |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `purchase_cost` | number | Purchase cost |
| ↳ `total_cost` | number | Total cost |
| ↳ `acquisition_date` | json | Acquisition date |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `expiry_date` | json | Expiry date |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `warranty_expiry` | json | Warranty expiry date |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `is_loaned` | boolean | Whether the asset is on loan |
| ↳ `is_in_contract` | boolean | Whether the asset is covered by a contract |

### ManageEngine SDP Delete Asset [#manageengine-sdp-delete-asset]

Delete an asset from the ManageEngine ServiceDesk Plus Cloud inventory.

#### Input [#input-25]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `assetId` | string | Yes | ID of the asset to delete |

#### Output [#output-25]

| Parameter | Type | Description |
| - | - | - |
| `deleted` | boolean | Whether the asset was deleted |

### ManageEngine SDP Create Solution [#manageengine-sdp-create-solution]

Add an article to the ManageEngine ServiceDesk Plus Cloud knowledge base under an existing topic.

#### Input [#input-26]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `title` | string | Yes | Solution title |
| `description` | string | Yes | Solution body. HTML is supported |
| `topic` | string | Yes | Name of an existing knowledge base topic to file the solution under |
| `keywords` | string | No | Search keywords for the solution |
| `isPublic` | boolean | No | Whether requesters can see the solution. Only takes effect once the solution is Approved |
| `udfFields` | json | No | Portal-defined custom fields, e.g. \{"udf\_char1":"value"} |

#### Output [#output-26]

| Parameter | Type | Description |
| - | - | - |
| `solution` | object | The created solution |
| ↳ `id` | string | Solution ID |
| ↳ `display_id` | json | Solution number shown in the SDP UI (display\_value, value) |
| ↳ `display_value` | string | Record number as shown in the UI, e.g. PB-140 |
| ↳ `value` | string | Bare sequence number, e.g. 140 |
| ↳ `title` | string | Solution title |
| ↳ `description` | string | Solution body (HTML) |
| ↳ `topic` | json | Topic the solution is filed under |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `parent_topic` | json | Parent topic |
| ↳ `approval_status` | json | Approval status |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `keywords` | string | Search keywords |
| ↳ `is_public` | boolean | Whether requesters can see the solution |
| ↳ `likes` | number | Like count |
| ↳ `dislikes` | number | Dislike count |
| ↳ `no_of_hits` | number | View count |
| ↳ `created_time` | json | Creation time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `last_updated_time` | json | Last update time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `review_date` | json | Date the solution is due for review |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `expiry_date` | json | Date the solution expires |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `created_by` | json | Author |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `last_updated_by` | json | User who last updated the solution |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `udf_fields` | json | Portal-defined custom fields |

### ManageEngine SDP Get Solution [#manageengine-sdp-get-solution]

Retrieve a single ManageEngine ServiceDesk Plus Cloud knowledge base solution by ID.

#### Input [#input-27]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `solutionId` | string | Yes | ID of the solution to retrieve |

#### Output [#output-27]

| Parameter | Type | Description |
| - | - | - |
| `solution` | object | The solution |
| ↳ `id` | string | Solution ID |
| ↳ `display_id` | json | Solution number shown in the SDP UI (display\_value, value) |
| ↳ `display_value` | string | Record number as shown in the UI, e.g. PB-140 |
| ↳ `value` | string | Bare sequence number, e.g. 140 |
| ↳ `title` | string | Solution title |
| ↳ `description` | string | Solution body (HTML) |
| ↳ `topic` | json | Topic the solution is filed under |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `parent_topic` | json | Parent topic |
| ↳ `approval_status` | json | Approval status |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `keywords` | string | Search keywords |
| ↳ `is_public` | boolean | Whether requesters can see the solution |
| ↳ `likes` | number | Like count |
| ↳ `dislikes` | number | Dislike count |
| ↳ `no_of_hits` | number | View count |
| ↳ `created_time` | json | Creation time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `last_updated_time` | json | Last update time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `review_date` | json | Date the solution is due for review |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `expiry_date` | json | Date the solution expires |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `created_by` | json | Author |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `last_updated_by` | json | User who last updated the solution |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `udf_fields` | json | Portal-defined custom fields |

### ManageEngine SDP List Solutions [#manageengine-sdp-list-solutions]

Search the ManageEngine ServiceDesk Plus Cloud knowledge base, with optional search criteria, sorting and paging.

#### Input [#input-28]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `rowCount` | number | No | Rows to return (maximum 100) |
| `startIndex` | number | No | One-based index of the first row to return |
| `sortField` | string | No | Field to sort on, e.g. created\_time |
| `sortOrder` | string | No | Sort direction: asc or desc |
| `searchCriteria` | json | No | Search criteria object or array, e.g. \{"field":"status.name","condition":"is","value":"Open"} |
| `fieldsRequired` | json | No | Array of field names to return, e.g. \["subject","status"] |
| `getTotalCount` | boolean | No | Include the total matching row count in list\_info |

#### Output [#output-28]

| Parameter | Type | Description |
| - | - | - |
| `solutions` | array | Matching solutions |
| ↳ `id` | string | Solution ID |
| ↳ `display_id` | json | Solution number shown in the SDP UI (display\_value, value) |
| ↳ `display_value` | string | Record number as shown in the UI, e.g. PB-140 |
| ↳ `value` | string | Bare sequence number, e.g. 140 |
| ↳ `title` | string | Solution title |
| ↳ `description` | string | Solution body (HTML) |
| ↳ `topic` | json | Topic the solution is filed under |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `parent_topic` | json | Parent topic |
| ↳ `approval_status` | json | Approval status |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `keywords` | string | Search keywords |
| ↳ `is_public` | boolean | Whether requesters can see the solution |
| ↳ `likes` | number | Like count |
| ↳ `dislikes` | number | Dislike count |
| ↳ `no_of_hits` | number | View count |
| ↳ `created_time` | json | Creation time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `last_updated_time` | json | Last update time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `review_date` | json | Date the solution is due for review |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `expiry_date` | json | Date the solution expires |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `created_by` | json | Author |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `last_updated_by` | json | User who last updated the solution |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `udf_fields` | json | Portal-defined custom fields |
| `count` | number | Number of solutions returned in this page |
| `listInfo` | object | Paging metadata echoed by ServiceDesk Plus |
| ↳ `row_count` | number | Rows returned |
| ↳ `start_index` | number | Index the page started at |
| ↳ `page` | number | Page number |
| ↳ `has_more_rows` | boolean | Whether more rows are available after this page |
| ↳ `sort_field` | string | Field the results were sorted on |
| ↳ `sort_order` | string | Sort direction |
| ↳ `total_count` | number | Total matching rows, present only when get\_total\_count was requested |

### ManageEngine SDP Update Solution [#manageengine-sdp-update-solution]

Update a ManageEngine ServiceDesk Plus Cloud knowledge base solution: revise its body, retitle it, or move it to another topic.

#### Input [#input-29]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `solutionId` | string | Yes | ID of the solution to update |
| `title` | string | No | New solution title |
| `description` | string | No | New solution body. HTML is supported |
| `topic` | string | No | Name of an existing topic to move the solution to |
| `keywords` | string | No | Search keywords for the solution |
| `isPublic` | boolean | No | Whether requesters can see the solution. Only takes effect once the solution is Approved |
| `udfFields` | json | No | Portal-defined custom fields, e.g. \{"udf\_char1":"value"} |

#### Output [#output-29]

| Parameter | Type | Description |
| - | - | - |
| `solution` | object | The updated solution |
| ↳ `id` | string | Solution ID |
| ↳ `display_id` | json | Solution number shown in the SDP UI (display\_value, value) |
| ↳ `display_value` | string | Record number as shown in the UI, e.g. PB-140 |
| ↳ `value` | string | Bare sequence number, e.g. 140 |
| ↳ `title` | string | Solution title |
| ↳ `description` | string | Solution body (HTML) |
| ↳ `topic` | json | Topic the solution is filed under |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `parent_topic` | json | Parent topic |
| ↳ `approval_status` | json | Approval status |
| ↳ `id` | string | Identifier |
| ↳ `name` | string | Display name |
| ↳ `keywords` | string | Search keywords |
| ↳ `is_public` | boolean | Whether requesters can see the solution |
| ↳ `likes` | number | Like count |
| ↳ `dislikes` | number | Dislike count |
| ↳ `no_of_hits` | number | View count |
| ↳ `created_time` | json | Creation time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `last_updated_time` | json | Last update time |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `review_date` | json | Date the solution is due for review |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `expiry_date` | json | Date the solution expires |
| ↳ `display_value` | string | Human-readable timestamp in the portal timezone |
| ↳ `value` | string | Epoch milliseconds as a string |
| ↳ `created_by` | json | Author |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `last_updated_by` | json | User who last updated the solution |
| ↳ `id` | string | User ID |
| ↳ `name` | string | User name |
| ↳ `email_id` | string | Email address |
| ↳ `phone` | string | Phone number |
| ↳ `mobile` | string | Mobile number |
| ↳ `is_technician` | boolean | Whether the user is a technician |
| ↳ `is_vip_user` | boolean | Whether the user is flagged VIP |
| ↳ `job_title` | string | Job title |
| ↳ `udf_fields` | json | Portal-defined custom fields |

### ManageEngine SDP Delete Solution [#manageengine-sdp-delete-solution]

Delete an article from the ManageEngine ServiceDesk Plus Cloud knowledge base, along with its comments and versions.

#### Input [#input-30]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `dataCenter` | string | No | Zoho data center hosting the portal (US, EU, IN, AU, JP, CA, SA, UK, CN, AE). Credentials connected through Sim are issued by the US accounts server and are only valid against US. |
| `portal` | string | No | Portal URL name. Leave empty to use the account default portal |
| `solutionId` | string | Yes | ID of the solution to delete |

#### Output [#output-30]

| Parameter | Type | Description |
| - | - | - |
| `deleted` | boolean | Whether the solution was deleted |