get_workspace

A workspace's access-control setting, chosen once at creation.

labels = [] is the default and means no filtering at all — no classification pass at ingestion, no filter clause at retrieval, and Coverage reports nothing. A workspace that does not need document-level access control should not pay for a classification that always returns the same answer.

Coverage reporting is always strict: whenever the gate withholds candidates, the response says so in counts and label names. A silently narrowed answer is the failure mode this platform exists to prevent, so there is no opt-out.

How this workspace's documents should be read where they leave a currency open.

Extraction never converts an amount and never invents a currency: one whose currency the source does not state is recorded as ambiguous with no value, so it matches no amount filter. New workspaces default to DEFAULT_WORKSPACE_CURRENCY (USD), so a corpus that writes every total as a bare $900.00 and names a currency nowhere is filterable out of the box. Set default to another ISO code to change the reading, or to null to assume nothing — an amount whose currency the source never states then stays ambiguous rather than being read as USD.

A workspace's knowledge-graph build policy.

The defaults keep the whole corpus in scope but build nothing until asked: a graph is billable and runs for as long as the corpus takes, so it is not something ingestion should commit a caller to as a side effect. Set auto_build=true for a workspace that does want one after every ingestion. exclude_path_prefixes and exclude_categories are the workspace-wide skip rules a file's graph_inclusion can override — a file matching either is left out of the graph corpus unless it is explicitly include\ d.

A workspace's retention setting, chosen once at creation.

derived_ttl_days anchors on ingested_at and source_ttl_days on created_at — one anchor each, not configurable.