Create or replace a pin by id

POST: optional client-minted id (any RFC 4122 UUID; the server mints a UUIDv7 otherwise). PUT/PATCH: ignored, the path id wins.

Name of the element. null stores ''.

Any kind of details about the element. null stores ''.

The top level category to which the element belongs. null stores ''.

The sub level category through which the element is further classified. null stores ''.

URL to an image representing the element. null stores ''.

x coordinate, from bottom left of the map.

y coordinate, from bottom left of the map.

z coordinate, in case of depth (optional).

Map that the pin is placed on. Links a Map: an existing one in this world.

The element this pin places on the map, of any type. Set together with element_id, or neither.

The element this pin places on the map, of any type. Set together with element_type, or neither.

Name of the element.

Any kind of details about the element.

The top level category to which the element belongs.

The sub level category through which the element is further classified.

URL to an image representing the element.

x coordinate, from bottom left of the map.

y coordinate, from bottom left of the map.

z coordinate, in case of depth (optional).

Map that the pin is placed on. A Map's id.

The element this pin places on the map, of any type. Generic link: the linked element's type ('' when unset).

The element this pin places on the map, of any type. Generic link: the linked element's id.

The world change sequence at this element's last write.

The world membership that created this element, or null when the world's owner did.

The world membership that last changed this element, or null when the world's owner (or the server) did, or no write has touched it since doors were recorded.

The door of the last change: seat (an agent seat), mcp (the MCP server), declared (the request sent an X-OW-Agent header), api, v1, sync (the mobile app's sync) or server (the server, on its own behalf). The first three mean an agent made it. Null: no write since doors were recorded.

Present, and true, only on an element this reader knows of but does not see whole: a guest or player reaches it only because its own Character's sheet links to it (one step out). Such a row keeps id, type, name, description, supertype, subtype, image_url, created_at, updated_at and change_seq; every other field reads as unset (text "", numbers and single links null, multi links [], created_by, changed_by and changed_via null, no extension fields), its files are 404, and search matches only its name and description. Absent: the element is whole. Any other grant (it names the reader's Character, the reader knows it, it is on the roster, the reader made it) makes it whole; a hidden element is never even a stub.