Replace library media source
replace_library_media_sourceUse when replacing the stored bytes for an existing image or uploaded video source after reading the latest updatedAt.
When to use it
Use when replacing the stored bytes for an existing image or uploaded video source after reading the latest updatedAt.
Search chunks, read only the precise chunk or bounded text needed, cite ids.
Source text, chunks, snippets, ids, and citation-ready context.
Avoid using it when
Do not use for text edits, YouTube URLs, pixel editing, or video trimming.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View full registry notes
Replace the stored bytes for an existing private image or video library source. Requires the latest updatedAt as expectedUpdatedAt. This cannot edit pixels, trim video, replace YouTube videos, delete, publish, or import arbitrary websites. Use when: Use when replacing the stored bytes for an existing image or uploaded video source after reading the latest updatedAt. Avoid when: Do not use for text edits, YouTube URLs, pixel editing, or video trimming.
View JSON Schema
{
"type": "object",
"properties": {
"fileId": {
"type": "string",
"format": "uuid"
},
"expectedUpdatedAt": {
"type": "string",
"format": "date-time"
},
"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"
},
"dataUrl": {
"type": "string"
},
"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
}
},
"required": [
"fileId",
"expectedUpdatedAt",
"filename",
"mimeType"
],
"additionalProperties": false
}