Revise Shared Goal
Changed onStart a conversation that revises this published goal, from its brief.
wonderland goals.md puts revising in the open on the page: while the live conversation is open the page just returns to it, and when it is gone this is the path. The goal brief is the whole input (#2870): a fresh conversation is seeded with the goal as the brief holds it, the page's version of it never, so the first coach turn works from everything the conversation settled without re-asking what it already says.
The owner's only. Revising is the athlete's; the reader who received the link starts a fresh goal instead. The brief is the athlete's own document, not the page, so seeding anyone else's conversation from it would hand them the conversation's words. A caller who does not own the goal gets the 404 an invented link gets, before any session rotates. A browser that lost its cookie cannot prove it is the owner, so it starts fresh too.
Unsafe with all three browser signals, because it replaces whatever conversation this browser had — the same posture, rotation and response shape as POST /goals/session/reset, so a client swallows it with the code it already has. What this conversation settles is the same goal (#3071): it lands on this goal's row and link as a dated revision, so the link the athlete already sent opens the revised goal.
The rotation carries the browser forward (#3070), so the goal stays the owner's after it, with nothing to move. Two revises from one browser at once (a double click) both answer 200, and whichever cookie lands last owns the goal, as the other would have.
The app revises on its bearer (#2635), and there the account is the owner (:func:_revise_on_bearer).
Request
- Base URLhttps://api.imperfect.co (the document declares no server; this is the origin it was published from)
- URLhttps://api.imperfect.co/goals/shared/{share_id}/revise
- AuthHTTP bearer
Path parameters
Headers
Response
Successful Response
Changes
- warning
removed the optional property
////from the response with the status - info
added the optional property
////to the response with the status
- warning
- info
added the optional property
//to the response with the status
- info