---
title: Quick-Actions
slug: neurons-for-itsm/admin-user-help/enu/latest/quick-actions
createdAt: 2026-07-14T19:16:28.719Z
---

Performs quick actions for a business object. For example, close, clone or resolve an incident or a problem.

For more information on quick actions and viewing a list of quick actions, see [Viewing a List of Quick Actions for a Business Object](docId\:qc7S-YrFjJGp1yBk_v-1s).

**Base URL:**

https\://\{tenant url}/api/odata/businessobject/\{business object name}('\{business object unique key}')/\{quick action name}

:::hint{type="info"}
- Ensure the business object name is suffixed with an "s".
- You can get the quick action ID from the [Metadata API](docId\:pkOCqFV2d86th3L22mGgY).
:::

::::ExpandableHeading
## Quick Action Example - Close an Incident

:::Paragraph{indent="2"}
Here is an example to close an incident using a quick action.
:::

| URL                                          | https\://\{tenant url}/api/odata/businessobject/incidents('\{Incident Rec ID}')/Close\_Incident                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| -------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <font color="#0C121D">Method</font>          | POST                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Header Name                                  | Authorization: JTW Token/Session Key/REST API Key                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| <font color="#0C121D">Request Payload</font> | `{`<br />`"ActionId":"3492dbcc-e502-44fd-9790-e3e45cb26c45",`<br />`"ShouldSave":true,`<br />`"ActionParams":{`<br />`"FormParams":{`<br />`"actionId":"3492dbcc-e502-44fd-9790-e3e45cb26c45",`<br />`"actualObjectType":"Incident#",`<br />`"objectId":"CAA8B29A4D24464FA68DBF281D7505B9"`<br />`},`<br />`"GridParams":null`<br />`},`<br />`"PromptParams":[`<br />`{`<br />`"__type":"DataLayer.PromptData",`<br />`"ActionId":null,`<br />`"ActionObjectId":null,`<br />`"PromptObjectId":"CAA8B29A4D24464FA68DBF281D7505B9",`<br />`"ActionObjectType":"Incident#",`<br />`"PromptObjectType":"Incident#",`<br />`"Value":"Closed",`<br />`"FieldName":"Status",`<br />`"IsNewPrompt":true`<br />`},`<br />`{`<br />`"__type":"DataLayer.PromptData",`<br />`"Label":"Select Cause Code",`<br />`"ActionId":"3492dbcc-e502-44fd-9790-e3e45cb26c45",`<br />`"ActionObjectId":"CAA8B29A4D24464FA68DBF281D7505B9",`<br />`"PromptObjectId":"CAA8B29A4D24464FA68DBF281D7505B9",`<br />`"ActionObjectType":"Incident#",`<br />`"PromptObjectType":"Incident#",`<br />`"Value":"Documentation Request",`<br />`"ValidList":"Incident Cause Code",`<br />`"FieldName":"CauseCode",`<br />`"FieldType":"list",`<br />`"FieldLength":40,`<br />`"Precision":0,`<br />`"FieldAreaWidth":400,`<br />`"FieldAreaHeight":200,`<br />`"Password":false,`<br />`"Required":true,`<br />`"DefaultValue":"",`<br />`"Hidden":false,`<br />`"IsNewPrompt":true`<br />`},`<br />`{`<br />`"__type":"DataLayer.PromptData",`<br />`"Label":"Is first call resolution?",`<br />`"ActionId":"3492dbcc-e502-44fd-9790-e3e45cb26c45",`<br />`"ActionObjectId":"CAA8B29A4D24464FA68DBF281D7505B9",`<br />`"PromptObjectId":"CAA8B29A4D24464FA68DBF281D7505B9",`<br />`"ActionObjectType":"Incident#",`<br />`"PromptObjectType":"Incident#",`<br />`"Value":null,`<br />`"ValidList":"",`<br />`"FieldName":"FirstCallResolution",`<br />`"FieldType":"boolean",`<br />`"FieldLength":0,`<br />`"Precision":0,`<br />`"FieldAreaWidth":0,`<br />`"FieldAreaHeight":0,`<br />`"Password":false,`<br />`"Required":false,`<br />`"DefaultValue":null,`<br />`"Hidden":false,`<br />`"IsNewPrompt":true`<br />`},`<br />`{`<br />`"__type":"DataLayer.PromptData",`<br />`"Label":"Resolution",`<br />`"ActionId":"3492dbcc-e502-44fd-9790-e3e45cb26c45",`<br />`"ActionObjectId":"CAA8B29A4D24464FA68DBF281D7505B9",`<br />`"PromptObjectId":"CAA8B29A4D24464FA68DBF281D7505B9",`<br />`"ActionObjectType":"Incident#",`<br />`"PromptObjectType":"Incident#",`<br />`"Value":"test",`<br />`"ValidList":"",`<br />`"FieldName":"Resolution",`<br />`"FieldType":"text",`<br />`"FieldLength":4000,`<br />`"Precision":0,`<br />`"FieldAreaWidth":400,`<br />`"FieldAreaHeight":200,`<br />`"Password":false,`<br />`"Required":true,`<br />`"DefaultValue":"",`<br />`"Hidden":false,`<br />`"IsNewPrompt":true`<br />`}`<br />`]`<br />`}` |
| <font color="#0C121D">Status Code</font>     | 200                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
::::

:::ExpandableHeading
## Quick Action Example - Assign an Incident

Here is an example to assign an incident using a quick action.

| URL                                      | https\://\{tenant url}/api/odata/businessobject/incidents('\{Incident Rec ID')/Assign\_Incident                                                                                                                                                                                                                                                                                       |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <font color="#0C121D">Method</font>      | POST                                                                                                                                                                                                                                                                                                                                                                                  |
| Header Name                              | Authorization: JTW Token/Session Key/REST API Key                                                                                                                                                                                                                                                                                                                                     |
|                                          | `{`<br />`"ActionId": "ec205b17-09ab-4405-87aa-246f2dce3960",`<br />`"ShouldSave": true,`<br />`"ActionParams": {`<br />`"GridParams": null,`<br />`"FormParams": {`<br />`"actionId": "ec205b17-09ab-4405-87aa-246f2dce3960",`<br />`"objectId": "C1B35DCEA41542E1AD0ED58775795ABA",`<br />`"actualObjectType": "Incident#"`<br />`}`<br />`},`<br />`"promptParams": null`<br />`}` |
| <font color="#0C121D">Status Code</font> | 200                                                                                                                                                                                                                                                                                                                                                                                   |
:::

:::ExpandableHeading
## Quick Action Example - Accept a Task

Here is an example to accept a task using a quick action.

| URL                                          | https\://\{tenant url}/api/odata/businessobject/tasks('\{Task Rec ID}')/Accept\_Task                                                                                                                                                                                                                                                                                                                                                   |
| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <font color="#0C121D">Method</font>          | POST                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Header Name                                  | Authorization: JTW Token/Session Key/REST API Key                                                                                                                                                                                                                                                                                                                                                                                      |
| <font color="#0C121D">Request Payload</font> | `{`<br />`"ActionId": "e383dc0e-28b4-4e7a-9ac2-66248f991d71",`<br />`"ShouldSave": true,`<br />`"ActionParams": {`<br />`"GridParams": {`<br />`"actionId": "e383dc0e-28b4-4e7a-9ac2-66248f991d71",`<br />`"recordIds": [`<br />`{`<br />`"RecordId": "C6CCA4CEC8094724900EF60993662A44",`<br />`"ObjectType": "Task#Assignment"`<br />`}`<br />`]`<br />`},`<br />`"FormParams": null`<br />`},`<br />`"PromptParams": null`<br />`}` |
| <font color="#0C121D">Status Code</font>     | 200                                                                                                                                                                                                                                                                                                                                                                                                                                    |
:::

## Unsuccessful Response

:::ExpandableHeading
## Missing Mandatory Information

Scenario: Trying to close an incident without providing the mandatory fields' information.

https\://\{tenant url}/api/odata/businessobject/incidents('E44D7F1B97534363B5FAD9DAAAFAECF1')/Close\_Incident

Header Name:

**Authorization: Sessionkey**

| Code                                          | ISM\_4000                                                                                                                                                                                                                                                                        |
| --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Description                                   | Invalid Request Payload                                                                                                                                                                                                                                                          |
| Message                                       | `[  `<br />`"Required Prompt Paramter 'Status' is missing",  `<br />`"Required Prompt Paramter 'CauseCode' is missing",  `<br />`"Required Prompt Paramter 'FirstCallResolution' is missing",  `<br />`"Required Prompt Paramter 'Resolution' is missing"  `<br />`"  `<br />`]` |
| <font color="#0C121D">HTTP STATUS CODE</font> | **400**                                                                                                                                                                                                                                                                          |
:::