Edit fields of an own draft; a released entry refuses every field
The first change by a person sets edited_at, and from that moment the engine may not replace the row. Every refusal carries a code and, per field, its rule and params (entry.*, duration.*, narrative.*, matter.*). Nothing is edited after release (D-164): every field a patch would move on a released entry is a 409 entry.released, each on its own path; a draft being released, or one the practice system may hold a line for, is a 409 entry.releasing; a deleted draft a 409 entry.deleted; an entry that is not the caller's a 404 entry.not_found. A local-only field is a 422 (D-85). A narrative over the limit (the firm's length, else 240, never above the practice system's ceiling or 1,023, measured trimmed) is a 422 narrative.too_long at narrative. matter_id may be null; a matter the caller may not name is a 422 matter.missing. reason is accepted and not stored. The time is parts, the whole new set of spans, or t_start and t_end, the one-span case, which on a draft of two spans or more is a 409 entry.changed on t_start. On a draft each span is a 422 urn:six-minute:problem:block whose detail is one sentence, on parts.N.t_start or parts.N.t_end (t_start or t_end for the one-span case): "An entry starts and ends on the day's interval lines." (entry.off_grid: each edge the patch moves is a stored cell's edge or a line of the day's unit, never inside a stored cell; D-219; the stored intervals are those of the device the entry was generated on (its device_id), or, for a hand-made entry and one generated on the asking device, those of the device X-Six-Minute-Device names and the earlier ids X-Six-Minute-Device-Known names; with no device of the caller's named, every device's for a hand-made entry), "An entry ends after it starts." (entry.empty) or "An entry stays inside its day." (entry.crosses_day). A span over another live entry of the person is a 409 with the same urn and "This time overlaps another entry." (entry.overlap). A time edit writes the row only (D-216). A change to the spans clears override_seconds; override_seconds alone sets the hours a person typed (whole units of the day's unit, at most a day, else a 422 duration.*) or clears them.
Request
- Base URLhttps://api.sixminute.ai (the document declares no server; this is the origin it was published from)
- AuthHTTP bearer
Path parameters
Request body
Response
The entry after the patch.
Changes
No recorded changes to this operation across all 2 revisions of this API.