Edit, retire or restore a line of the master
const url = 'http://127.0.0.1:8765/api/master/lines';const options = { method: 'PUT', headers: {'Content-Type': 'application/json'}, body: '{"actor":"agent","id":"b-hex-03","revision":3,"text":"Led the migration of 40 services to Helm charts released through ArgoCD, in 5 months."}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url http://127.0.0.1:8765/api/master/lines \ --header 'Content-Type: application/json' \ --data '{ "actor": "agent", "id": "b-hex-03", "revision": 3, "text": "Led the migration of 40 services to Helm charts released through ArgoCD, in 5 months." }'Edit, retire or restore one line of the master, by id. use edit needs at least one of text, tags, backed, note (422 master_edit_empty; an entry’s id with text, tags or backed is 422 master_edit_invalid). note is one line of at most 300 characters; one that holds a comment mark (<!--, -->) or a word that starts with id:, tags:, backed: or gigai-master: is 422 master_note_invalid, and one that looks like contact data is 422 personal_info_refused. A note edit is one revision; the line’s mark stays, so no resume is printed again and no assessment goes stale. use retire: the line is never selected again; it stays in the earlier revisions and is listed by GET /api/master/history (the last line of the master cannot go: 409 master_empty). use restore: the line comes back under its own id, as the last revision that held it had it, where it stood; a line that is in the master is 409 master_line_exists, and a line whose role is retired too is 404 master_entry_not_found: restore the role first (PUT /api/master/entries), which brings the lines it had. This is also “save this wording to your master” for a line edited on a tailored resume: send the line’s item_id as id with the edited text. One new revision of the master. Send the revision you read: when the master changed since, the reply is 409 revision_conflict with error.current (the revision it is at now): read it again, then send the change on top of that. A text that looks like contact data (email, phone, link, address, a name line) answers 422 personal_info_refused and nothing is written. These are the rules of gigai scout resume master add | edit | remove (one implementation), so a refusal carries that command’s code. The reply carries the whole master after the write, status (revised, or unchanged when it already said this) with written, the id the change was about, retired (what the write took out, each with the revision that still holds it), and profiles: what the write did to the profiles’ selections (synced: a profile that shows an edited or retired line had its resume printed again; offers: new lines are offered, never added by themselves). Every tailoring made from the master is out of date after a write and is made again when the pipeline next looks at its profile. file says where the revision went in the resumes folder (null when nothing was written): wrote is master.md, or the file beside it (master-2.md) when master.md holds changes the user has not imported, which GigAI never replaces. Local only: no model call.
Request Bodyrequired
Section titled “Request Bodyrequired”object
Who writes: recorded as written_by. Also the X-GigAI-Actor header. Without either, a write from the Scout UI (a browser page of this server) is the operator’s and any other loopback write is the agent’s.
With use edit: the evidence, whole.
The line’s id.
With use edit: the note, one line of at most 300 characters that says when this is the one to use ("" removes it). Read by the assessment and the user’s agent; never printed in a resume.
The revision of the master you read; when it changed since, the reply is 409.
With use edit: the tags, whole (an empty array removes them).
With use edit: the new wording (one line; the id stays).
Edit (the default) changes text, tags, backed and/or note; retire takes the line out of the master; restore puts a retired one back.
Example
{ "actor": "agent", "id": "b-hex-03", "revision": 3, "text": "Led the migration of 40 services to Helm charts released through ArgoCD, in 5 months."}Responses
Section titled “Responses”Success.
object
Example
{ "action": "edit", "changes": { "added": 0, "changed": 1, "removed": 0 }, "file": { "beside": null, "name": "master.md", "not_imported": false, "path": "~/Documents/GigAI/resumes/master.md", "revision": 3, "state": "current", "written": true, "wrote": "master.md" }, "id": "b-hex-03", "ids": [ "b-hex-03" ], "master": { "content_sha256": "sha256:...", "counts": { "by_kind": { "bullet": 1, "other": 0, "skills": 1, "summary": 1 }, "by_strength": { "backed": 0, "quantified": 1, "stated": 2 }, "entries": 1, "ids": 4, "items": 3, "skills": 3 }, "entries": [ { "bullets": [ "b-hex-03" ], "end": 2023, "heading": "Hexa Cloud", "id": "r-hex", "note": null, "ongoing": false, "order": 3, "section": "experience", "source": null, "start": 2019, "sublines": [ "Staff Software Engineer | Jun 2019 - Jan 2023" ], "written_by": null } ], "format": 1, "items": [ { "backed": [], "entry_id": "r-hex", "id": "b-hex-03", "kind": "bullet", "mark": "5d0c2a4b9e1f7a36", "note": "agentic roles: lead with this", "order": 4, "section": "experience", "source": "from the user's chat on 3 Oct", "strength": "quantified", "tags": [ "delivery" ], "text": "Led the migration of 40 services to Helm charts released through ArgoCD.", "written_by": "agent" } ], "parent_revision": "revision_7c1d7b9a-0d58-4f0b-8f27-91f4f6f6a2c3", "record_id": "record_...", "revision": 3, "revision_id": "revision_0b6f2f0e-5a0e-4c58-9a57-2d1b6a0c1e11", "revisions": 3, "sections": [ "summary", "experience", "skills" ], "updated_at": "2026-10-04T10:05:00.000000Z", "written_by": "operator" }, "near_duplicates": [], "profiles": { "offers": [ { "label": "Staff Engineer", "new_lines": [ "b-4f0c1a" ], "offer": "1 new master line: refresh?", "profile_id": "prof_1" } ], "synced": [] }, "retired": [], "schema_version": "scout-master:1", "skills": { "added": [], "already_listed": [], "line": null, "removed": [] }, "status": "revised", "warnings": [], "written": true}Forbidden / forbidden_origin: loopback peer and Host 127.0.0.1:<port> or localhost:<port> only (Origin too on writes).
object
object
Examplegenerated
{ "error": { "allowed_keys": [ "example" ], "code": "example", "message": "example" }}Master_not_found, target_unavailable, master_item_not_found, master_entry_not_found
object
object
Example
{ "error": { "code": "master_not_found", "message": "..." }}Revision_conflict, master_line_exists, master_empty
object
object
Example
{ "error": { "code": "revision_conflict", "message": "..." }}Unsupported_media_type: writes need Content-Type: application/json.
object
object
Examplegenerated
{ "error": { "allowed_keys": [ "example" ], "code": "example", "message": "example" }}Unknown_key, wrong_type, invalid_value, personal_info_refused, master_text_invalid, master_markdown_invalid, master_edit_empty, master_edit_invalid, master_tag_invalid, master_backed_invalid, master_note_invalid
object
object
Example
{ "error": { "code": "unknown_key", "message": "..." }}