> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# servicenow-attachment

> ServiceNow Attachments - upload, download, and manage files on records

**Server path:** `/servicenow-attachment` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                          | Description                          |
| ----------------------------------------------------------------------------- | ------------------------------------ |
| [`servicenow_attachment_delete_file`](#servicenow_attachment_delete_file)     | Delete an attachment                 |
| [`servicenow_attachment_download_file`](#servicenow_attachment_download_file) | Download attachment file content     |
| [`servicenow_attachment_get_file_info`](#servicenow_attachment_get_file_info) | Get attachment metadata              |
| [`servicenow_attachment_list_files`](#servicenow_attachment_list_files)       | List attachments                     |
| [`servicenow_attachment_upload_file`](#servicenow_attachment_upload_file)     | Upload a file attachment to a record |

***

## servicenow\_attachment\_delete\_file

Delete an attachment

**Parameters:**

| Parameter | Type   | Required | Default | Description                         |
| --------- | ------ | -------- | ------- | ----------------------------------- |
| `sys_id`  | string | Yes      | —       | sys\_id of the attachment to delete |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "sys_id": {
        "type": "string",
        "description": "sys_id of the attachment to delete"
      }
    },
    "required": [
      "PCID",
      "sys_id"
    ]
  }
  ```
</Expandable>

***

## servicenow\_attachment\_download\_file

Download attachment file content

**Parameters:**

| Parameter | Type   | Required | Default | Description                           |
| --------- | ------ | -------- | ------- | ------------------------------------- |
| `sys_id`  | string | Yes      | —       | sys\_id of the attachment to download |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "sys_id": {
        "type": "string",
        "description": "sys_id of the attachment to download"
      }
    },
    "required": [
      "PCID",
      "sys_id"
    ]
  }
  ```
</Expandable>

***

## servicenow\_attachment\_get\_file\_info

Get attachment metadata

**Parameters:**

| Parameter | Type   | Required | Default | Description                      |
| --------- | ------ | -------- | ------- | -------------------------------- |
| `sys_id`  | string | Yes      | —       | sys\_id of the attachment record |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "sys_id": {
        "type": "string",
        "description": "sys_id of the attachment record"
      }
    },
    "required": [
      "PCID",
      "sys_id"
    ]
  }
  ```
</Expandable>

***

## servicenow\_attachment\_list\_files

List attachments

**Parameters:**

| Parameter        | Type    | Required | Default | Description                                                                   |
| ---------------- | ------- | -------- | ------- | ----------------------------------------------------------------------------- |
| `sysparm_query`  | string  | No       | —       | Encoded query filter (e.g., 'table\_name=incident^table\_sys\_id=\<sys\_id>') |
| `sysparm_limit`  | integer | No       | —       | Maximum number of attachments to return                                       |
| `sysparm_offset` | integer | No       | —       | Starting index for pagination                                                 |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "sysparm_query": {
        "type": "string",
        "description": "Encoded query filter (e.g., 'table_name=incident^table_sys_id=<sys_id>')"
      },
      "sysparm_limit": {
        "type": "integer",
        "description": "Maximum number of attachments to return"
      },
      "sysparm_offset": {
        "type": "integer",
        "description": "Starting index for pagination"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## servicenow\_attachment\_upload\_file

Upload a file attachment to a record

**Parameters:**

| Parameter            | Type   | Required | Default | Description                                                                                                                                 |
| -------------------- | ------ | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `table_name`         | string | Yes      | —       | Name of the table the record belongs to (e.g., incident)                                                                                    |
| `table_sys_id`       | string | Yes      | —       | sys\_id of the record to attach the file to                                                                                                 |
| `file_name`          | string | Yes      | —       | File name including extension (e.g., report.pdf, screenshot.png)                                                                            |
| `encryption_context` | string | No       | —       | sys\_id of an encryption context to encrypt the attachment                                                                                  |
| `body`               | string | Yes      | —       | File content as a string. For text files (CSV, JSON, XML, plain text), provide the raw content. Binary files are not supported through MCP. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "table_name": {
        "type": "string",
        "description": "Name of the table the record belongs to (e.g., incident)"
      },
      "table_sys_id": {
        "type": "string",
        "description": "sys_id of the record to attach the file to"
      },
      "file_name": {
        "type": "string",
        "description": "File name including extension (e.g., report.pdf, screenshot.png)"
      },
      "encryption_context": {
        "type": "string",
        "description": "sys_id of an encryption context to encrypt the attachment"
      },
      "body": {
        "type": "string",
        "description": "File content as a string. For text files (CSV, JSON, XML, plain text), provide the raw content. Binary files are not supported through MCP."
      }
    },
    "required": [
      "PCID",
      "table_name",
      "table_sys_id",
      "file_name",
      "body"
    ]
  }
  ```
</Expandable>