Config

Read, write, and audit tenant configuration sections.

Overview

The Config resource provides full CRUD access to tenant configuration sections (guardrails, routing, memory, etc.) with audit trailing and atomic imports.

Methods

list()

List all configuration sections visible to the current API key (RBAC-filtered). Returns a keyed object map.

const sections = await client.config.list();
// { data: { guardrails: { value: {...}, version: 3, updatedAt: "..." }, routing: { ... } } }

sections = client.config.list()
# sections["data"]["guardrails"]["version"]  # => 3

get(key)

Get a specific configuration section by key.

const guardrails = await client.config.get("guardrails");
// { data: { enabled: true, ... }, version: 3, updatedAt: "..." }

guardrails = client.config.get("guardrails")

set(key, value, opts?)

Replace a configuration section entirely (full PUT). Supports optimistic concurrency via ifMatch/if_match.

await client.config.set("guardrails", { enabled: true, piiEnabled: true });

// With optimistic concurrency (returns 409 if version changed)
await client.config.set("guardrails", { enabled: true }, { ifMatch: 3 });

`

client.config.set("guardrails", {"enabled": True, "piiEnabled": True})

# With optimistic concurrency
client.config.set("guardrails", {"enabled": True}, if_match=3)

`

patch(key, value, opts?)

Merge-patch a configuration section (RFC 7396). Only supplied keys are updated. Supports optimistic concurrency via ifMatch/if_match.

await client.config.patch("guardrails", { piiEnabled: false });

// With optimistic concurrency
await client.config.patch("guardrails", { piiEnabled: false }, { ifMatch: 4 });

`

client.config.patch("guardrails", {"piiEnabled": False})

# With optimistic concurrency
client.config.patch("guardrails", {"piiEnabled": False}, if_match=4)

`

delete(key)

Reset a configuration section to its defaults.

await client.config.delete("guardrails");

client.config.delete("guardrails")

audit(key)

Get the audit trail for a configuration section, showing all changes with actor attribution.

const trail = await client.config.audit("guardrails");
// { data: [{ event: "config.updated", actorId: "user-1", ... }] }

trail = client.config.audit("guardrails")

MCP Tools

Tool	Description	Permission
br_list_config	List all config sections	config.read
br_get_config	Get a config section by key	config.read
br_set_config	Update a config section	config.write