Skip to content

org operations

The exact fields each org.* operation takes and returns.

Every op is POST /v1/<op> over HTTP and the MCP tool loom_<op>. The identity fields (org, namespace, agent, user_id, session_id) are filled from the token and the MCP session when a transport can; for an HTTP call with no token on a single-user server, the install's org on every op but code.* and tracker.* (which keep their plane's), and on some ops its namespace and agent; see identities and namespaces. The operations index explains role, kind and the MCP all listing. Unknown input fields are served and named in ignored_args.

org.model_calls

The org's current setting; enabled and unlocked when it was never set.

POST /v1/org.model_calls · MCP loom_org_model_calls · role org_admin · idempotent · not listed under the MCP all toolset

Input field Type Default Meaning
org str required The tenant (first element of the identity tuple).
Output field Type Meaning
org str The tenant (first element of the identity tuple).
enabled bool Whether the org's data may go to a model; true when it was never set.
reason str The note given with the last change; "" when none.
updated_by str Who made the last change; "" when it was never set.
updated_at datetime \| None When the setting last changed (UTC), None when it was never set; while off, when it was switched off, whatever else changed since.
locked bool Whether a platform admin locked the setting: its admins cannot switch it on.
locked_by str The platform admin who set the lock; "" when unlocked.

org.set_model_calls

Switch the org's model calls off or on.

POST /v1/org.set_model_calls · MCP loom_org_set_model_calls · role org_admin · idempotent · audited · not listed under the MCP all toolset

Input field Type Default Meaning
org str required The tenant (first element of the identity tuple).
enabled bool required False switches the org's model calls off; true switches them back on.
reason str '' A note on why, kept with the setting; at most 500 characters.
locked bool \| None None Platform admins only: true locks the setting (the org's own admins may switch it off, not back on), false unlocks it; unset leaves the lock as it is.
Output field Type Meaning
org str The tenant (first element of the identity tuple).
enabled bool Whether the org's data may go to a model; true when it was never set.
reason str The note given with the last change; "" when none.
updated_by str Who made the last change; "" when it was never set.
updated_at datetime \| None When the setting last changed (UTC), None when it was never set; while off, when it was switched off, whatever else changed since.
locked bool Whether a platform admin locked the setting: its admins cannot switch it on.
locked_by str The platform admin who set the lock; "" when unlocked.