{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-developer/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Changelog","description":"Read US healthcare contracts and organizations, and work with your saved work, from your own code.","siteUrl":"https://docs.hrcledger.com","llmstxt":{"title":"HRC Ledger API","description":"One key, one envelope, every route and guide."}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"changelog","__idx":0},"children":["Changelog"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every change to the API contract is listed here, newest first, with its date. A"," ","change that would break your code only comes with a new version in the path. See"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/developer/pagination-and-versioning"},"children":["Pagination and versioning"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"2026-10-16","__idx":1},"children":["2026-10-16"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contract fingerprint: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["642c798400a3"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your saved work is now in the API. A key can read and change your Lists, action"," ","plans, drafts and conversations, and read what HRC Ledger knows about your company."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["New routes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Lists"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/lists"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/v1/lists"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/lists/{id}"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH /api/v1/lists/{id}"]}," (rename), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/v1/lists/{id}/rows"]}," (add or"," ","remove organizations), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/v1/lists/{id}/archive"]},", and"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/lists/{id}/export.csv"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Action plans"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/actions/steps"]}," (your steps across every plan, with"," ","the total), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/actions/plans"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/v1/actions/plans"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/actions/plans/{id}"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH /api/v1/actions/plans/{id}"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/v1/actions/plans/{id}/steps/{stepId}/status"]},", and"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/v1/actions/plans/{id}/archive"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Drafts"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/drafts"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/drafts/approved"]}," (approved drafts"," ","with their text), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/v1/drafts"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/drafts/{id}"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH /api/v1/drafts/{id}"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/v1/drafts/{id}/archive"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reviews"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/v1/reviews/{artifactId}/approve"]}," approves a draft or plan"," ","that is waiting for review. A draft needs ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["drafts:approve"]}," and a plan"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["actions:approve"]},". It never decides a change the assistant proposed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Conversations"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/conversations"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/conversations/{id}"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH /api/v1/conversations/{id}"]}," (rename), and"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE /api/v1/conversations/{id}"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Memory"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/memory"]}," reads what HRC Ledger knows about your company,"," ","with where each entry came from."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["New scopes: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lists:read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lists:write"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["actions:read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["actions:write"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["drafts:read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["drafts:write"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["drafts:approve"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["actions:approve"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["conversations:read"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["conversations:write"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["memory:read"]},". A key can also hold"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data:query"]}," now; no route uses it yet. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/developer/keys-and-scopes"},"children":["Keys and scopes"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["New error codes: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["revision_conflict"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["step_changed"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["idempotency_conflict"]}," and"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["person_required"]},". See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/developer/errors"},"children":["Errors"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Calls that make something take an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Idempotency-Key"]}," header, so a retry makes it"," ","once. The new list routes page with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cursor"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]},"."]}]},"headings":[{"value":"Changelog","id":"changelog","depth":1},{"value":"2026-10-16","id":"2026-10-16","depth":2}],"frontmatter":{"seo":{"title":"Changelog"}},"lastModified":"2026-10-22T07:39:08.493Z","pagePropGetterError":{"message":"","name":""}},"slug":"/developer/changelog","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}