---
title: org operations
---

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

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

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](/reference/http-api#request) its namespace and agent; see [identities and namespaces](/concepts/identities-and-namespaces). The [operations index](/reference/operations) explains role, kind and the MCP `all` listing. Unknown input fields are served and named in `ignored_args`.

<!-- prettier-ignore-start -->

## `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. |

<!-- prettier-ignore-end -->
