profile_schema operations

The exact fields each profile_schema.* 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.

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.