OptionalcontextThe id of the context. Optional: when omitted, the server generates one and rejects the upload if another context in the knowledge base already holds identical content (content-level dedup). Provide an explicit id to address a specific context — that overwrites it unconditionally and allows duplicate content across different ids.
OptionaldiscardWhether Squid keeps or discards the original file.
Keeping the original file allows reprocessing and the ability for the user to download it later.
Defaults to false.
OptionalextractWhether to extract images from the file; defaults to false.
OptionalimageThe AI model to use for extraction, if specified.
OptionalimageThe minimum size for extracted images, if applicable.
OptionalmetadataOptional metadata associated with the context item.
OptionaloptionsGeneral options for how to process the file.
OptionalpreferredThe preferred method for extracting data from the document.
Specifies the context type as 'file'.
Request structure for adding file-based context to an AI agent.