---
title: profile_schema operations
---

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

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

## `profile_schema.clear`

Clear the schema: no profile is built or rebuilt for the namespace, and reads answer `no_schema`.

`POST /v1/profile_schema.clear` · MCP `loom_profile_schema_clear` · role `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). |
| `namespace` | `str` | required | The namespace the op reads or writes. |

| Output field | Type | Meaning |
| --- | --- | --- |
| `found` | `bool` | False when the namespace has no profile schema. |
| `json_schema` | `dict[str, Any]` | The schema as the admin set it, in their key order; {} when not found. |
| `schema_sha256` | `str` | SHA-256 of the schema's properties (not its titles or order), which each profile names. |
| `updated_by` | `str` | The actor (`human:<subject>` or `process:<subject>`) that last set or cleared it; empty when not found, or for a token narrowed to one user. |
| `updated_at` | `datetime \| None` | When it was last set or cleared; None when not found. |

## `profile_schema.get`

The namespace's profile schema, its hash, and who set it when.

`POST /v1/profile_schema.get` · MCP `loom_profile_schema_get` · role `viewer` · read · not listed under the MCP `all` toolset

| Input field | Type | Default | Meaning |
| --- | --- | --- | --- |
| `org` | `str` | required | The tenant (first element of the identity tuple). |
| `namespace` | `str` | required | The namespace the op reads or writes. |

| Output field | Type | Meaning |
| --- | --- | --- |
| `found` | `bool` | False when the namespace has no profile schema. |
| `json_schema` | `dict[str, Any]` | The schema as the admin set it, in their key order; {} when not found. |
| `schema_sha256` | `str` | SHA-256 of the schema's properties (not its titles or order), which each profile names. |
| `updated_by` | `str` | The actor (`human:<subject>` or `process:<subject>`) that last set or cleared it; empty when not found, or for a token narrowed to one user. |
| `updated_at` | `datetime \| None` | When it was last set or cleared; None when not found. |

## `profile_schema.set`

Set the namespace's profile schema.

`POST /v1/profile_schema.set` · MCP `loom_profile_schema_set` · role `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). |
| `namespace` | `str` | required | The namespace the op reads or writes. |
| `json_schema` | `dict[str, Any]` | required | A JSON Schema object of 1-64 `properties`, each with a `type` and a `description` (at most 16 KiB); replaces the namespace's schema, and a change to its properties makes every profile stale. |

| Output field | Type | Meaning |
| --- | --- | --- |
| `found` | `bool` | False when the namespace has no profile schema. |
| `json_schema` | `dict[str, Any]` | The schema as the admin set it, in their key order; {} when not found. |
| `schema_sha256` | `str` | SHA-256 of the schema's properties (not its titles or order), which each profile names. |
| `updated_by` | `str` | The actor (`human:<subject>` or `process:<subject>`) that last set or cleared it; empty when not found, or for a token narrowed to one user. |
| `updated_at` | `datetime \| None` | When it was last set or cleared; None when not found. |

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