`knowledge_graph` — Knowledge graph

Files used to build a structured knowledge graph for the agent. Section key knowledge_graph · Shape object · Tier All plans
Edit in the dashboard: Knowledge page

Fields

Field	Required	Type	Allowed values / constraints	Default	Description
`files`	no	array of object	—	—	List of uploaded knowledge-graph files. Item fields below.

`files` items

List of uploaded knowledge-graph files.

Field	Required	Type	Allowed values / constraints	Default	Description
`filename`	yes	string	—	—	Original upload filename.
`stored_name`	yes	string	—	—	Canonical name assigned to the processed file (always .json).
`triple_count`	yes	integer	—	—	Number of triples (edges) in the graph.
`node_count`	no	integer	—	—	Number of nodes with metadata (label/description). Optional; absent for edges-only files.
`size_bytes`	yes	integer	—	—	File size in bytes.
`uploaded_at`	yes	string	—	—	ISO 8601 upload timestamp.
`source`	no	enum	one of `json`, `csv_zip`, `text`	—	Input adapter that produced this file.
`status`	no	enum	one of `ready`, `extracting`, `failed`	—	Processing status. ‘extracting’ = the file is still being processed (text source only); ‘failed’ = processing errored.
`error`	no	string	—	—	Failure detail when status===‘failed’.
`source_path`	no	string	—	—	Identifier linking an auto-extracted graph back to the internal document it was extracted from. Absent for directly-uploaded graphs.
`retrieval_enabled`	no	boolean	—	—	Owner toggle. When false, this graph is excluded from search (the knowledge_graph_query tool skips it). Absent/true = considered in search.