<a id="profile_schema-operations"></a>

# Operações de `profile_schema`

<!-- i18n: source=docs/reference/operations/profile_schema.md blob=8733b163e298cbd52443a5ffa68aaf5c4a6ab110 model=claude-sonnet-5-5 -->
> Esta página é uma tradução automática da [página em inglês](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations/profile_schema.md), que prevalece.
> Machine-translated from the [English page](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations/profile_schema.md), which is authoritative.


Os campos exatos que cada operação `profile_schema.*` recebe e retorna.

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

Toda op é `POST /v1/<op>` via HTTP e a ferramenta MCP `loom_<op>`. Os campos de identidade (`org`, `namespace`, `agent`, `user_id`, `session_id`) são preenchidos a partir do token e da sessão MCP quando o transporte consegue; em uma chamada HTTP sem token em um servidor de usuário único, é preenchida a org da instalação em todas as ops, exceto `code.*` e `tracker.*` (que mantêm a do seu plano), e em [algumas ops](https://github.com/ClickHouse/loom/blob/main/docs/reference/http-api.md#request) também o namespace e o agente; veja [identidades e namespaces](/pt-BR/concepts/identities-and-namespaces). O [índice de operações](https://github.com/ClickHouse/loom/blob/main/docs/reference/operations.md) explica papel, tipo e a listagem `all` do MCP. Campos de entrada desconhecidos são atendidos e listados em `ignored_args`.

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

<a id="profile_schemaclear"></a>

## `profile_schema.clear`

Limpa o schema: nenhum perfil é criado ou recriado para o namespace, e as leituras respondem `no_schema`.

`POST /v1/profile_schema.clear` · MCP `loom_profile_schema_clear` · papel `admin` · idempotente · auditada · não listada no toolset `all` do MCP

| Campo de entrada | Tipo | Padrão | Significado |
| --- | --- | --- | --- |
| `org` | `str` | obrigatório | O tenant (primeiro elemento da tupla de identidade). |
| `namespace` | `str` | obrigatório | O namespace que a op lê ou grava. |

| Campo de saída | Tipo | Significado |
| --- | --- | --- |
| `found` | `bool` | False quando o namespace não tem schema de perfil. |
| `json_schema` | `dict[str, Any]` | O schema como o admin o definiu, na ordem de chaves dele; {} quando não encontrado. |
| `schema_sha256` | `str` | SHA-256 das propriedades do schema (não dos títulos nem da ordem), que cada perfil nomeia. |
| `updated_by` | `str` | O ator (`human:<subject>` ou `process:<subject>`) que o definiu ou limpou por último; vazio quando não encontrado, ou para um token restrito a um usuário. |
| `updated_at` | `datetime \| None` | Quando foi definido ou limpo por último; None quando não encontrado. |

<a id="profile_schemaget"></a>

## `profile_schema.get`

O schema de perfil do namespace, seu hash e quem o definiu e quando.

`POST /v1/profile_schema.get` · MCP `loom_profile_schema_get` · papel `viewer` · leitura · não listada no toolset `all` do MCP

| Campo de entrada | Tipo | Padrão | Significado |
| --- | --- | --- | --- |
| `org` | `str` | obrigatório | O tenant (primeiro elemento da tupla de identidade). |
| `namespace` | `str` | obrigatório | O namespace que a op lê ou grava. |

| Campo de saída | Tipo | Significado |
| --- | --- | --- |
| `found` | `bool` | False quando o namespace não tem schema de perfil. |
| `json_schema` | `dict[str, Any]` | O schema como o admin o definiu, na ordem de chaves dele; {} quando não encontrado. |
| `schema_sha256` | `str` | SHA-256 das propriedades do schema (não dos títulos nem da ordem), que cada perfil nomeia. |
| `updated_by` | `str` | O ator (`human:<subject>` ou `process:<subject>`) que o definiu ou limpou por último; vazio quando não encontrado, ou para um token restrito a um usuário. |
| `updated_at` | `datetime \| None` | Quando foi definido ou limpo por último; None quando não encontrado. |

<a id="profile_schemaset"></a>

## `profile_schema.set`

Define o schema de perfil do namespace.

`POST /v1/profile_schema.set` · MCP `loom_profile_schema_set` · papel `admin` · idempotente · auditada · não listada no toolset `all` do MCP

| Campo de entrada | Tipo | Padrão | Significado |
| --- | --- | --- | --- |
| `org` | `str` | obrigatório | O tenant (primeiro elemento da tupla de identidade). |
| `namespace` | `str` | obrigatório | O namespace que a op lê ou grava. |
| `json_schema` | `dict[str, Any]` | obrigatório | Um objeto JSON Schema com 1 a 64 `properties`, cada uma com um `type` e uma `description` (no máximo 16 KiB); substitui o schema do namespace, e uma mudança nas propriedades torna todos os perfis obsoletos. |

| Campo de saída | Tipo | Significado |
| --- | --- | --- |
| `found` | `bool` | False quando o namespace não tem schema de perfil. |
| `json_schema` | `dict[str, Any]` | O schema como o admin o definiu, na ordem de chaves dele; {} quando não encontrado. |
| `schema_sha256` | `str` | SHA-256 das propriedades do schema (não dos títulos nem da ordem), que cada perfil nomeia. |
| `updated_by` | `str` | O ator (`human:<subject>` ou `process:<subject>`) que o definiu ou limpou por último; vazio quando não encontrado, ou para um token restrito a um usuário. |
| `updated_at` | `datetime \| None` | Quando foi definido ou limpo por último; None quando não encontrado. |

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