Save chat attachment to Prism
upload_library_attachmentSave a host-provided chat attachment as a private Project source when the host exposes a valid temporary download URL.
When to use it
Use when the connected host supplies a first-class chat file attachment; pass it in the required top-level file field so Prism can ingest it as a private Project source. Host application/octet-stream metadata is accepted when the declared MIME, extension, and detected signature validate.
Find candidate library objects before reading full evidence.
Metadata lists, ids, snippets, activity, and discovery hints.
Avoid using it when
Do not use with a filename-only reference, arbitrary remote URL, or YouTube link. If the host cannot expose the attachment, use a byte-based upload tool instead.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View full registry notes
Save a user-provided chat attachment (image, video, audio, PDF, document, or spreadsheet) into an authorized Prism Project. Pass the host-provided file object with a temporary HTTPS download_url; never invent a URL or pass a sandbox path. Maximum 15MB; use Prism direct upload for larger video files. Returns the saved file id and metadata. Use when: Use when the connected host supplies a first-class chat file attachment; pass it in the required top-level file field so Prism can ingest it as a private Project source. Host appl... Avoid when: Do not use with a filename-only reference, arbitrary remote URL, or YouTube link. If the host cannot expose the attachment, use a byte-based upload tool instead.
View JSON Schema
{
"type": "object",
"properties": {
"folderId": {
"type": "string",
"format": "uuid"
},
"folderPath": {
"type": "string",
"maxLength": 512,
"description": "Folder name or /-delimited path; an alternative to folderId so no prior lookup is needed."
},
"createFolderPath": {
"type": "boolean",
"description": "Create any missing folders named in folderPath."
},
"file": {
"type": "object",
"properties": {
"download_url": {
"type": "string"
},
"file_id": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"file_name": {
"type": "string"
}
},
"required": [
"download_url",
"file_id"
],
"additionalProperties": false
},
"filename": {
"type": "string",
"minLength": 1,
"maxLength": 180
},
"mimeType": {
"type": "string",
"enum": [
"application/pdf",
"application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"application/vnd.openxmlformats-officedocument.presentationml.presentation",
"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
"text/plain",
"text/markdown",
"text/csv",
"image/png",
"image/jpeg",
"image/gif",
"image/webp",
"image/heic",
"image/heif",
"audio/mpeg",
"video/mp4",
"video/webm",
"video/quicktime"
]
},
"description": {
"type": "string",
"maxLength": 4000
},
"sourceKind": {
"type": [
"string",
"null"
],
"enum": [
null,
"document",
"web_page",
"article",
"social_post",
"note",
"email",
"transcript",
"presentation",
"dataset",
"image",
"audio",
"video",
"book_or_paper",
"other",
"news_article",
"video_transcript",
"research_report",
"company_press_release",
"quarterly_filing",
"annual_filing",
"sec_filing",
"earnings_call",
"investor_presentation"
]
},
"tags": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 40
},
"maxItems": 12
},
"compareKnowledge": {
"type": "boolean"
}
},
"required": [
"file",
"filename",
"mimeType"
],
"additionalProperties": false
}