OptionalextractWhether to extract images: inline markdown/HTML images for text contexts, embedded images for files.
OptionalformatHint about a text context's format; only meaningful for type: 'text'.
OptionalmetadataOptional metadata associated with the context item; mirrors BaseAiKnowledgeBaseContextRequest.metadata.
Squid-reserved keys are stripped server-side, and values are validated/normalized against the target
knowledge base's metadataFields schema when one is declared.
OptionalpreferredThe preferred method for extracting data from a file context; mirrors the sync lane's field of the same name, so a caller's choice survives whichever lane a deployment routes the upload through.
OptionalstagedKey returned by bulk/createUploadUrls; the server ingests the staged object as this context's file. Mutually exclusive with a positional multipart file.
OptionaltextThe text content to stage; required for type: 'text'.
OptionaltitleTitle for a text context (required); optional display title for a file context.
Optionaltype'text' (the default) stages a text context; 'file' consumes the next uploaded file positionally.
One context to stage through bulk ingestion.