From d2c05c17bc58cdbedfb0a702b2858c52aff2eedf Mon Sep 17 00:00:00 2001 From: tv Date: Sun, 1 Nov 2026 22:22:07 +0100 Subject: api: PUT changes only what differs --- docs/openapi.yaml | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) (limited to 'docs') diff --git a/docs/openapi.yaml b/docs/openapi.yaml index a6b7d84..662b46b 100644 --- a/docs/openapi.yaml +++ b/docs/openapi.yaml @@ -96,9 +96,10 @@ paths: tags: [Store] summary: Write a value description: | - Writes the value, creating intermediate maps (not lists). In a list, an index - replaces the item there, the list's length appends, and past it is `404`. One - request is one Automerge change. Answers with the value written (JSON, or text with + Writes the value, creating intermediate maps (not lists): the path then reads as + the value, what was there changed only where it differs (`api.md`, Concurrent + writes). In a list, an index overwrites the item there, the list's length + appends, and past it is `404`. One request is one Automerge change. Answers with the value written (JSON, or text with `Accept: text/plain`). JSON maps and arrays become Automerge maps and lists; numbers become integers @@ -137,7 +138,7 @@ paths: Inserts the value (as `PUT` takes it) into a list: the path ends in the index it goes to (`queue/2`), the items from there on moving up one; the list's length, or `-1` (a `307` to it), appends. One request is one Automerge change. - To add a key to a map, `PUT` it; to replace an item, `PUT` its index. + To add a key to a map, `PUT` it; to overwrite an item, `PUT` its index. requestBody: required: true content: -- cgit v1.3.1