update_workspace
Change a workspace's mutable configuration. Cost class: fast.
Presence-aware, and whole-block: an omitted field is left alone, a supplied one replaces its block entirely. Read the workspace, edit the block, send it back — partial blocks fall back to the schema defaults, which is how a caller flipping auto_build would otherwise wipe its own exclusion rules.
Graph builds are explicit by default: a build happens when POST /v1/workspaces/{id}/knowledge-graph/builds asks for one. Turning knowledge_graph.auto_build on hands that trigger to ingestion instead, for a workspace that wants a graph over everything it ingests and accepts the bill for one per ingestion. Either way a build already in flight is unaffected — cancel it if that is what you meant.
currency follows the same whole-block rule, so {} is how its policy is cleared. Setting currency.default changes how the next ingestion reads amounts marked with a symbol that names several currencies ($, ¥, kr); amounts already extracted as ambiguous stay that way until their file is re-ingested, because the catalog records what a past extraction could read.
Ordinary workspace names are mutable without changing identity or storage; platform-provisioned workspace names remain fixed. The domain and label list are deliberately not mutable here. They are part of the versioned config record stamped onto every derived artifact, so editing them in place would re-describe material that was derived under the old one.
Args: context: Resolved workspace plus the caller's access predicate. session: Database session. request: The name and/or blocks to replace.
Returns: The workspace as it now stands.
Raises: PlatformError: workspace_not_found, workspace_deleting when a teardown is in flight; workspace_name_taken for an occupied name, invalid_request for a system-workspace rename, access_denied when a shared member attempts a rename.
Request
- Base URLhttps://ndi-api.nace.ai (the document declares no server; this is the origin it was published from)
- AuthAPI key in header X-API-Key
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Path parameters
Workspace identifier.
Request body
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.