Replace the binary of a file
Replaces the binary backing an existing file knowledge_source. The KS id is preserved
(so embeddings keep their identity in downstream stores); the row’s name, title,
source and data.original* fields are refreshed to match the new file.
The new file may have a different filename and extension from the previous one — replace is keyed by KS id, not by filename. A 422 is returned if the new filename collides with another active file in the same folder.
Side-effects mirror an initial upload: the old S3 object is removed, the new binary is
stored under the same KS id, Markdown is re-parsed (Firecrawl / Cortex vision / plaintext
depending on extension), page thumbnails are regenerated, and data.hasManualMarkdownEdits
is reset to false. A knowledgeSourceChanged action=update event is emitted so Cortex
re-embeds the new content.
Authorizations
JWT-based authentication
Path Parameters
Knowledge source ID
Body
New binary that should back this knowledge source.