docs(skill): GET 을 그대로 되보내면 400 이라는 것을 PUT 설명 옆에 적는다

`references/studio-api.md` 는 「서버가 주지만 보내지 않는 것: id · version ·
updatedAt」을 이미 적고 있었는데, 그 문장이 PUT 요청 모양을 설명하는 절이
아니라 한 절 아래 「종류마다의 칸」에 있었다. 2026-09-17 에 서로 다른 두
작업이 같은 자리에서 400 VALIDATION_FAILED / UnrecognizedPropertyException
을 맞았다 — 둘 다 GET 으로 받은 document 를 그대로 되보냈다.

내용을 더한 것이 아니라 PUT 을 설명하는 자리에서 그 표를 가리키게 했다.
서버 상태는 안 바뀌므로 셋을 빼고 다시 보내면 된다는 것도 적었다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
DongHyeonka
2026-09-17 20:34:56 +09:00
co-authored by Claude Opus 5
parent b1a78752df
commit 862e502af3
@@ -87,6 +87,11 @@ body: { "expectedVersion": <읽어 온 document.version>, "document": { … }
`document`**그 종류의 칸을 전부** 담는다. 빠뜨린 칸은 비는 것으로 저장된다 — 부분 갱신이
아니다.
**다만 `GET` 으로 받은 것을 그대로 되보내면 400 이다.** `id` · `version` · `updatedAt` 은 서버가
주기만 하고 받지는 않아서, 그 셋이 들어 있으면 `VALIDATION_FAILED`
`UnrecognizedPropertyException` 으로 거절된다(2026-09-17 에 두 번 겪었다). 서버 상태는 안
바뀌니 셋을 빼고 다시 보내면 된다. 어느 칸을 보내고 어느 칸을 빼는지는 바로 아래 표에 있다.
## 종류마다의 칸
여섯이 함께 갖는 것: `kind` · `title` · `slug` · `summary` · `relations` · `projectId` ·