Upload library media source
upload_library_media_sourceUse when the user wants an image or local video file saved in an authorized Prism Project.
When to use it
Use when the user wants an image or local video file saved in an authorized Prism Project. Confirm that the host can expose the attachment bytes before constructing base64. For audio, use upload_library_file_source.
Find candidate library objects before reading full evidence.
Metadata lists, ids, snippets, activity, and discovery hints.
Avoid using it when
Do not use for YouTube URLs; use preview_youtube_transcript_source and import_youtube_transcript_source instead. The server accepts up to 15 MB decoded bytes, while a connected host may impose a lower payload limit.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View full registry notes
Save supplied image or video bytes as a library source in an authorized Prism Project folder. Provide a matching filename and MIME type and exactly one of mediaBase64 or dataUrl, up to 15 MB decoded. Stores the file with optional tags and a searchable description; access follows the destination Project permissions. Use when: Use when the user wants an image or local video file saved in an authorized Prism Project. Confirm that the host can expose the attachment bytes before constructing base64. For au... Avoid when: Do not use for YouTube URLs; use preview_youtube_transcript_source and import_youtube_transcript_source instead. The server accepts up to 15 MB decoded bytes, while a connected ho...
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."
},
"filename": {
"type": "string",
"minLength": 1,
"maxLength": 180
},
"mimeType": {
"type": "string",
"enum": [
"image/png",
"image/jpeg",
"image/webp",
"image/gif",
"video/mp4",
"video/webm",
"video/quicktime"
]
},
"mediaBase64": {
"type": "string",
"description": "Base64 encoded image or video bytes. Use either mediaBase64 or dataUrl, not both."
},
"dataUrl": {
"type": "string",
"description": "Base64 media data URL such as image/png or video/mp4. Use either dataUrl or mediaBase64, not both."
},
"description": {
"type": "string",
"maxLength": 4000,
"description": "Optional searchable description, alt text, caption, or transcript summary for retrieval."
},
"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": [
"filename",
"mimeType"
],
"additionalProperties": false
}