Endpoints — Schema, PUT
Every call in this family: what the card records, the edge cases that live on the call, and the verdict of every entry that measured it. Each of those lines names the door holding that entry's rules. The map is corpus/INDEX.md.
PUT /schema/<Type>/fields/<field>
Changes a field's properties. A body changing data_type is a 200 that does nothing, so read the field back rather than trusting the status code.
data_typeis immutable and the API does not say so. The write answers 200 and the value is unchanged. This is the sharpest case of the general rule that a 200 from this API proves the request parsed, not that it happened.A property the update does not take is a 400 that lists the ones it does. For
hidden_valueson a status field the list wasname,visible,description,summary_default,default_value,valid_values,custom_metadata, with or withoutproject_id(probe 114).hidden_valuescannot be written over REST.A top-level key the call does not take is ignored when
propertiesis present:{"unique": true, "properties": [...]}is a 200 that applies the properties and leavesuniquealone (probe 116).Which properties a field takes depends on its
data_type, and the field says so: each one readseditable: trueinGET /schema/<Type>/fields/<field>. Probe 116 has the table.One refused property refuses the request: the others are not applied.
valid_valuesanddefault_valuesent together are checked against each other, in either order (probe 121).Changing an
entityfield'svalid_typescreates a field on each type added and retires the one on each type removed. A retired name stays taken (probe 121).Renaming changes the display name only. The programmatic name is fixed at creation, and a rename does not free the old one for reuse.
Measured by
040_field_revive(findings) — A trashed field is revived by POST /schema//fields/ with {"revive": true} at 204, but it returns at its original data_type, and a PUT changing data_type is a 200 that does nothing.
rules:doors/findings-schema091_status_summary_exclusions(findings) — Excluded statuses are invisible to REST: not in /schema at any scope, not writable by PUT. status_list honours them: fin plus an excluded omt rolls up to fin, omt alone to na.
rules:doors/findings-schema114_schema_admin_recheck(findings) — On 2026-11-10 /spec.json names calls to enable, disable and configure a custom entity, all 400 code 111 on the probed site. No call deletes a trashed field forever or writes hidden_values.
rules:doors/findings-schema115_field_visibility_per_project(findings) —visibleis per project. Read it with?project_id=N; write it with PUT andproject_idin the body or the query, never without one. A new field is visible in every project.
rules:doors/findings-schema116_field_settings_create_update(findings) — A create takes description, unique, valid_values, default_value and valid_types.uniqueand a multi_entity's valid_types never change afterwards; an entity's valid_types and list values do.
rules:doors/findings-schema117_field_types_and_names(findings) — One non-ASCII character in the display name and the field is namedsg_<data_type>, at 201. ASCII names are lowercased, every other character becomes_, nothing is trimmed or cut.
rules:doors/findings-schema118_field_writes_other_types(findings) — Create, update, per-projectvisible, retire, the retired-name 400 and revive answer on a custom entity and on Tag, which has noprojectfield, exactly as on Version.
rules:doors/findings-schema119_field_absent_retired_live(findings) — Revive is 204 only on a retired field: 404Retired field ... does not exist.on an unused name, 400... is not retired.on a live one. A retired field is a 404 to GET, PUT and DELETE.
rules:doors/findings-schema121_field_settings_edges(findings) — A PUT applies all its properties or none, in any order. A description or name cannot be emptied.valid_typeskeeps the sent order, and a lowercase type name is a 500 that retires the field.
rules:doors/findings-schema132_field_create_rights(findings) — An Artist creating a field gets 500 code 105User doesn't have permission to create a Field, with a traceback. An Admin person gets 201. Treat any 500 from a schema write as a possible refusal.
rules:doors/findings-schema142_reverse_field(findings) — Every entity or multi_entity field makes a visible, editable multi_entity on each linked type. No create property stops it, and DELETE of the reverse field retires the forward field too.
rules:doors/findings-schema167_rollup_on_shot(findings) — A query (summary) field cannot be created over REST: 400data_type is not valid, with or without a query. Total each Shot's Bid Lines with one_summarizegrouped on the link.
rules:doors/findings-filter024_field_visibility_in_a_project(recipes) — Read which fields of an entity type a project hides, and show or hide one field in one project without touching the others
rules:doors/recipes
Silent on this call
put_schema_type_fields_field— Changes a field's properties. A body changingdata_typeis a 200 that does nothing, so read the field back rather than trusting the status code.040_field_revive— A trashed field is revived by POST /schema//fields/ with {"revive": true} at 204, but it returns at its original data_type, and a PUT changing data_type is a 200 that does nothing. 117_field_types_and_names— One non-ASCII character in the display name and the field is namedsg_<data_type>, at 201. ASCII names are lowercased, every other character becomes_, nothing is trimmed or cut.
corpus/endpoints/put_schema_type_fields_field.md