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"
}