Change part of a resource
Either text replacements in its code — [{ "old": "…", "new": "…" }], each old matching exactly once (code is stored formatted: copy old from what GET answered; 409 EDIT_NO_MATCH quotes the closest line) — or a JSON merge patch of its fields (application/merge-patch+json or JSON; null removes a field). One layer changes alone at its own path (frame/intro/title with { "props": { … } }). Checked like PUT.
Authorizations
Headers
The revision (ETag) you read — one, or a comma-separated list of which any current one matches — compared strongly (a weak W/"…" tag never matches): refused with 412 PRECONDITION_FAILED if the resource changed since or no longer exists (the problem carries currentRevision, null when it is gone, and for a layer frameRevision: either is taken). A layer takes its own revision or that of the frame/<id> it is in. *: it must exist. Checked atomically with the write: of two writes sent at once with the same revision, one lands and the other is 412.
Retry safely: the key (per caller, workspace, method and path) is taken before the request runs, and its first answer is replayed for 24 hours, with Idempotency-Replayed: true — a repeat sent while the first still runs waits for it. The same key with a different body is 422 IDEMPOTENCY_KEY_REUSED. A 5xx is not kept: the retry runs.
200Path Parameters
Response
The answer
What a draft operation answers. summary says what happened in a sentence; value is what a read found.