Skip to content
All tools

servicenow_add_comment

ServiceNow · macOS · Windows

Effect: write (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

macOS

Purpose

Add a comment or work note to a ServiceNow incident. Comments are visible to the caller; work notes are internal only. Called without confirm it returns a preview and sends nothing; pass confirm=true to add it.

Required inputs

Permissions and confirmation

Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the action.

Full input schema — macOS
{
  "properties": {
    "confirm": {
      "description": "Must be true to send; without it nothing is sent and the call returns a preview of every field.",
      "type": "boolean"
    },
    "sys_id": {
      "description": "Incident sys_id from servicenow_get_incident",
      "type": "string"
    },
    "text": {
      "description": "Comment or work note text",
      "type": "string"
    },
    "type": {
      "description": "'comment' (visible to caller, default) or 'work_note' (internal only)",
      "type": "string"
    }
  },
  "required": [
    "sys_id",
    "text"
  ],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "confirm": false,
  "sys_id": "0123456789abcdef0123456789abcdef",
  "text": "Can we review the launch checklist on Tuesday?"
}

Windows

Purpose

Add a comment or work note to a ServiceNow incident. Comments are visible to the caller; work notes are internal only. Without confirm=true nothing is sent: the answer previews the incident, the kind and the text.

Required inputs

Permissions and confirmation

Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the action.

Full input schema — Windows
{
  "properties": {
    "confirm": {
      "description": "Must be true to send. Without it nothing is sent and the answer previews every field.",
      "type": "boolean"
    },
    "sys_id": {
      "description": "Incident sys_id from servicenow_get_incident",
      "type": "string"
    },
    "text": {
      "description": "Comment or work note text",
      "type": "string"
    },
    "type": {
      "description": "'comment' (visible to caller, default) or 'work_note' (internal only)",
      "type": "string"
    }
  },
  "required": [
    "sys_id",
    "text"
  ],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "confirm": false,
  "sys_id": "0123456789abcdef0123456789abcdef",
  "text": "Can we review the launch checklist on Tuesday?"
}