add_case_attachments

Attach files or URLs to a Pega case at any lifecycle stage. Use temporary file IDs or direct URLs in a single atomic operation—ensuring all attachments succeed or none are added.

Instructions

Attach files and/or URLs to a Pega case regardless of the context or stage of the case lifecycle. Can attach temporary uploaded files using their IDs (from upload_attachment tool), or add URL/link attachments directly. Supports multiple attachments in a single atomic operation - if any attachment fails, no attachments are added to the case.

Input Schema

Name	Required	Description	Default
`attachments`	Yes	Array of attachment objects to add to the case. Can contain file attachments (using temporary attachment IDs from upload_attachment tool) and/or URL attachments. All attachments must be successfully processed or none will be attached (atomic operation).
`caseID`	Yes	Full case handle (case ID) to attach files/URLs to. Example: "OSIEO3-DOCSAPP-WORK T-561003". Must be a complete case identifier including spaces and special characters.

Input Schema (JSON Schema)

{
  "properties": {
    "attachments": {
      "description": "Array of attachment objects to add to the case. Can contain file attachments (using temporary attachment IDs from upload_attachment tool) and/or URL attachments. All attachments must be successfully processed or none will be attached (atomic operation).",
      "items": {
        "properties": {
          "ID": {
            "description": "Temporary attachment ID returned from upload_attachment tool (required for File type). Example: \"450b7275-8868-43ca-9827-bcfd9ec1b54b\". Note: Temporary attachments expire after 2 hours if not linked to a case.",
            "type": "string"
          },
          "category": {
            "description": "Attachment category. Must match the type (\"File\" or \"URL\").",
            "enum": [
              "File",
              "URL"
            ],
            "type": "string"
          },
          "name": {
            "description": "Display name for the URL attachment (required for URL type). Example: \"google\". This will be shown as the attachment name in the case.",
            "type": "string"
          },
          "type": {
            "description": "Attachment type. Must be \"File\" for file attachments or \"URL\" for URL/link attachments.",
            "enum": [
              "File",
              "URL"
            ],
            "type": "string"
          },
          "url": {
            "description": "URL/link to attach to the case (required for URL type). Example: \"https://www.google.com\". Must be a valid URL format.",
            "type": "string"
          }
        },
        "required": [
          "type",
          "category"
        ],
        "type": "object"
      },
      "maxItems": 50,
      "minItems": 1,
      "type": "array"
    },
    "caseID": {
      "description": "Full case handle (case ID) to attach files/URLs to. Example: \"OSIEO3-DOCSAPP-WORK T-561003\". Must be a complete case identifier including spaces and special characters.",
      "type": "string"
    }
  },
  "required": [
    "caseID",
    "attachments"
  ],
  "type": "object"
}

Pega DX MCP Server