Update library file metadata
update_library_file_metadataUse for renaming a source or updating source kind, tags, or searchable media description.
When to use it
Use for renaming a source or updating source kind, tags, or searchable media description.
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
Use update_library_file_content for editable .txt/.md bodies and replace_library_media_source for media bytes.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View full registry notes
Update filename, labels, tags, or searchable description for an owned Prism library source. Use this for image/video captions or alt-style context. This cannot replace bytes, edit text bodies, delete, publish, or import websites. Use when: Use for renaming a source or updating source kind, tags, or searchable media description. Avoid when: Use update_library_file_content for editable .txt/.md bodies and replace_library_media_source for media bytes.
View JSON Schema
{
"type": "object",
"properties": {
"fileId": {
"type": "string",
"format": "uuid"
},
"expectedUpdatedAt": {
"type": "string",
"format": "date-time"
},
"filename": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"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
},
"description": {
"type": "string",
"maxLength": 4000,
"description": "Optional replacement searchable description/caption. This never changes canonical source text, provenance, or content revision."
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Required for preview. Reuse only to retry this exact metadata change."
},
"operationId": {
"type": "string",
"format": "uuid",
"description": "Operation returned by the matching preview."
},
"commitToken": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"description": "Commit token returned by the matching preview."
},
"mode": {
"type": "string",
"enum": [
"preview",
"commit"
],
"default": "preview"
}
},
"required": [
"fileId",
"expectedUpdatedAt"
],
"additionalProperties": false
}