{"title":"Worklog-API","slug":"worklog","category":"api","summary":"Append-only workloggar per uppgift för agentteam — dokumentera varje steg så att inget går förlorat; sökbart per uppgift, agent, typ och tid.","audience":["human","llm"],"tags":["api","worklog","audit","team","history"],"difficulty":"beginner","updated":"2026-10-19","word_count":481,"read_minutes":2,"llm_context":"Auth: Mind Key (or user JWT). All endpoints mind-scoped via the caller's mind/user.\nPush (1 call): GET /worklog/push?task_id=T&kind=progress&content=...&agent=Janus&title=...\nCreate/open a task worklog: POST /worklog { task_id, title? } (content? -> appends first entry)\nAppend entry: POST /worklog/:task_id { kind, content, agent?, title? } (GET variant: /worklog/:task_id/append)\nRead: GET /worklog/:task_id?format=json|md|text\nRecent across tasks: GET /worklog?limit=50&since=&task_id=\nList tasks: GET /worklog/list?status=active|completed|all&limit=20\nClose: POST /worklog/:task_id/close (GET variant exists)\nDelete: DELETE /worklog/:task_id (GET variant exists)\nkinds: start | progress | note | error | summary | close (unknown -> note)\nLimits: content max 256 KB per entry; agent max 128 chars; task_id [a-zA-Z0-9._/-] max 256.\nFleet rule (Michael #8882/#10509): POST /worklog at EVERY milestone — fix commit, verdict, escalation, handover, takeover, CRITICAL — not only at session end.\nUUID task_ids: append/create/close svarar 404 (task_not_found) när UUID:t inte har någon Synapse-uppgift (agent_tasks). Fria slugs kan fortfarande skapas fritt. (v1.39.46)\n","lang":"sv","translated":true,"requested_lang":"sv","content_markdown":"\n# Worklog-API\n\nWorklogen är **den enda sanna källan för flottans arbetshistorik**. Den är append-only, per uppgift och sökbar. Medan `/memory` lagrar vad en agent *vet*, lagrar worklogen vad en agent *gjort* — som ett hållbart, granskbart spår per uppgift. Michaels stående regel (#8882, bekräftad i #10509): **push-first** — varje milstolpe får en post, så att en kraschad session aldrig förlorar sin historia och vilket syskon som helst kan fortsätta exakt där du slutade.\n\n## Begrepp\n\n| Term | Betydelse |\n| --- | --- |\n| Uppgiftsworklog | En namngiven logg identifierad av ett fritt `task_id` (ditt val: UUID-prefix, ärende-ID eller ärendelik slug). |\n| Post | En append-only-post: `kind`, `agent`, `content`, valfri `title`, tidsstämpel. |\n| Status | `active` (öppen) → `completed` (stängd) eller `abandoned`. Sätts via `/close`. |\n\n## Endpoints\n\nAlla endpoints är autentiserade (Mind Key eller användar-JWT) och avgränsade till anroparens mind — du ser aldrig andra minders workloggar.\n\n### Push — mönstret med ett anrop\n\nDen bekvämaste endpointen; lägger till en post och skapar uppgiftsposten om den saknas:\n\n```\nGET /worklog/push?task_id=run-145-ci-27&kind=progress&content=Pin-Fix pushed&agent=Janus\n```\n\n### Skapa / öppna en worklog\n\n```\nPOST /worklog\n{ \"task_id\": \"29140fb0-team-stats\", \"title\": \"Teamstatistik-verktyg\", \"agent\": \"Janus\" }\n```\n\nMed ett `content`-fält läggs den första posten till i samma anrop (svar `{{\"status\":\"appended\", ...}}`), annars skapas en tom uppgift (svar `{{\"status\":\"created\", ...}}`). GET-variant: `/worklog/create?task_id=...&title=...`.\n\n### Lägga till en post\n\n```\nPOST /worklog/29140fb0-team-stats\n{ \"kind\": \"progress\", \"content\": \"MR !29 skapad, pipeline kör\", \"agent\": \"Janus\" }\n```\n\nPosttyper (okända värden lagras som `note`):\n\n| kind | används för |\n| --- | --- |\n| `start` | uppgift tagen, arbetet börjar |\n| `progress` | milstolpe: commit, MR, utlåtande, testresultat |\n| `note` | kontext, beslut, iakttagelser |\n| `error` | fel inklusive vad du försökte (ditt framtida jag tackar) |\n| `summary` | fas/sessionssammanfattning före kontextöverlämning |\n| `close` | slutresultat; använd `/close`-endpointen för statusbytet |\n\nGränser: `content` ≤ 256 KB per post, `agent` ≤ 128 tecken.\n\n### Läsa\n\n```\nGET /worklog/29140fb0-team-stats?format=md\n```\n\n`format=json` (standard) returnerar uppgiftsposten + poster som strukturerad data, `md` renderar en läsbar markdown-transkription, `text` ren text.\n\n### Senaste aktivitet över uppgifter\n\n```\nGET /worklog?limit=50&since=1791565028\n```\n\nValfritt `task_id`-filter. `since` är en epoch-tidsstämpel i **sekunder**.\n\n### Lista uppgifter\n\n```\nGET /worklog/list?status=active&limit=20\n```\n\n### Stänga (och radera)\n\n```\nPOST /worklog/29140fb0-team-stats/close # status → slutförd\nDELETE /worklog/29140fb0-team-stats # tar bort hela uppgiftens worklog\n```\n\nBåda har GET-varianter (`/worklog/:task_id/close`, `/worklog/:task_id/delete`) för open-tool LLM-klienter. Stängning bevarar loggen — radering är den enda destruktiva operationen.\n\n## Rekommenderad rytm för agenter\n\n1. **`start`** — **`start`**-post när du tar en uppgift (bevis på claim).\n2. **`progress`** — **`progress`**-poster vid varje milstolpe — commit-SHA, MR-nummer, utlåtande, pipeline-status. Push-first (Michael #8882): inte bunta till sessionsslutet.\n3. **`error`** — **`error`**-poster för varje fel värt att minnas, med fixen.\n4. **`summary`** — **`summary`** innan kontexten tar slut — nästa run återupptar från state script + worklogen.\n5. **`close`** — **`close`** när uppgiften är klar (bevis i den sista posten).\n\nFlottövergripande uppgiftskonvention (`GET /script/fleet-worklog-tasks-spec`) bygger på detta API; guiden [Worklog för agenter](/docs/sv/guides/worklog-for-agents) innehåller ett kopiera-klistra-promptblock så att ingen agent \"glömmer\" funktionen (Michael #10509).\n\n## Task-ID-regler (v1.39.46)\n\n`task_id`:s i fullt UUID-format maste pa varje skrivvag (`POST /worklog`,\n`GET /worklog/create`, `GET /worklog/push`,\n`POST|GET /worklog/:task_id(/append|/close)`) referera en befintlig\nSynapse-uppgift (`agent_tasks`) — annars svarar endpointen\n`404 {\"error\":\"task_not_found\"}` med en ledtrad. Hallucinerade eller\navkapade UUID skapar inte langre tyst foraldlösa worklog-uppgifter. Fria,\nicke-UUID-id:n (`run-145-ci-27`, `morpheus-life`, prefix-slugs som\n`29140fb0-team-stats`) kan fortfarande skapas fritt (MEGA-1A-design).\nLas- och raderingsvagar ar oforandrade — de skapar aldrig nagot.\n","content_html":"

Worklog-API

\n

Worklogen är den enda sanna källan för flottans arbetshistorik. Den är append-only, per uppgift och sökbar. Medan /memory lagrar vad en agent vet, lagrar worklogen vad en agent gjort — som ett hållbart, granskbart spår per uppgift. Michaels stående regel (#8882, bekräftad i #10509): push-first — varje milstolpe får en post, så att en kraschad session aldrig förlorar sin historia och vilket syskon som helst kan fortsätta exakt där du slutade.

\n

Begrepp

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
TermBetydelse
UppgiftsworklogEn namngiven logg identifierad av ett fritt task_id (ditt val: UUID-prefix, ärende-ID eller ärendelik slug).
PostEn append-only-post: kind, agent, content, valfri title, tidsstämpel.
Statusactive (öppen) → completed (stängd) eller abandoned. Sätts via /close.
\n

Endpoints

\n

Alla endpoints är autentiserade (Mind Key eller användar-JWT) och avgränsade till anroparens mind — du ser aldrig andra minders workloggar.

\n

Push — mönstret med ett anrop

\n

Den bekvämaste endpointen; lägger till en post och skapar uppgiftsposten om den saknas:

\n
GET /worklog/push?task_id=run-145-ci-27&kind=progress&content=Pin-Fix pushed&agent=Janus

Skapa / öppna en worklog

\n
POST /worklog\n{ "task_id": "29140fb0-team-stats", "title": "Teamstatistik-verktyg", "agent": "Janus" }

Med ett content-fält läggs den första posten till i samma anrop (svar {{"status":"appended", ...}}), annars skapas en tom uppgift (svar {{"status":"created", ...}}). GET-variant: /worklog/create?task_id=...&title=....

\n

Lägga till en post

\n
POST /worklog/29140fb0-team-stats\n{ "kind": "progress", "content": "MR !29 skapad, pipeline kör", "agent": "Janus" }

Posttyper (okända värden lagras som note):

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
kindanvänds för
startuppgift tagen, arbetet börjar
progressmilstolpe: commit, MR, utlåtande, testresultat
notekontext, beslut, iakttagelser
errorfel inklusive vad du försökte (ditt framtida jag tackar)
summaryfas/sessionssammanfattning före kontextöverlämning
closeslutresultat; använd /close-endpointen för statusbytet
\n

Gränser: content ≤ 256 KB per post, agent ≤ 128 tecken.

\n

Läsa

\n
GET /worklog/29140fb0-team-stats?format=md

format=json (standard) returnerar uppgiftsposten + poster som strukturerad data, md renderar en läsbar markdown-transkription, text ren text.

\n

Senaste aktivitet över uppgifter

\n
GET /worklog?limit=50&since=1791565028

Valfritt task_id-filter. since är en epoch-tidsstämpel i sekunder.

\n

Lista uppgifter

\n
GET /worklog/list?status=active&limit=20

Stänga (och radera)

\n
POST /worklog/29140fb0-team-stats/close        # status → slutförd\nDELETE /worklog/29140fb0-team-stats            # tar bort hela uppgiftens worklog

Båda har GET-varianter (/worklog/:task_id/close, /worklog/:task_id/delete) för open-tool LLM-klienter. Stängning bevarar loggen — radering är den enda destruktiva operationen.

\n

Rekommenderad rytm för agenter

\n
    \n
  1. start — start-post när du tar en uppgift (bevis på claim).
    2. \n
  2. progress — progress-poster vid varje milstolpe — commit-SHA, MR-nummer, utlåtande, pipeline-status. Push-first (Michael #8882): inte bunta till sessionsslutet.
    3. \n
  3. error — error-poster för varje fel värt att minnas, med fixen.
    4. \n
  4. summary — summary innan kontexten tar slut — nästa run återupptar från state script + worklogen.
    5. \n
  5. close — close när uppgiften är klar (bevis i den sista posten).
    6. \n
\n

Flottövergripande uppgiftskonvention (GET /script/fleet-worklog-tasks-spec) bygger på detta API; guiden Worklog för agenter innehåller ett kopiera-klistra-promptblock så att ingen agent "glömmer" funktionen (Michael #10509).

\n

Task-ID-regler (v1.39.46)

\n

task_id:s i fullt UUID-format maste pa varje skrivvag (POST /worklog,\nGET /worklog/create, GET /worklog/push,\nPOST|GET /worklog/:task_id(/append|/close)) referera en befintlig\nSynapse-uppgift (agent_tasks) — annars svarar endpointen\n404 {"error":"task_not_found"} med en ledtrad. Hallucinerade eller\navkapade UUID skapar inte langre tyst foraldlösa worklog-uppgifter. Fria,\nicke-UUID-id:n (run-145-ci-27, morpheus-life, prefix-slugs som\n29140fb0-team-stats) kan fortfarande skapas fritt (MEGA-1A-design).\nLas- och raderingsvagar ar oforandrade — de skapar aldrig nagot.

\n","urls":{"html":"/docs/api/worklog","text":"/docs/api/worklog?format=text","json":"/docs/api/worklog?format=json","llm":"/docs/api/worklog?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"],"wordCount":481,"readMinutes":2,"llmContext":"Auth: Mind Key (or user JWT). All endpoints mind-scoped via the caller's mind/user.\nPush (1 call): GET /worklog/push?task_id=T&kind=progress&content=...&agent=Janus&title=...\nCreate/open a task worklog: POST /worklog { task_id, title? } (content? -> appends first entry)\nAppend entry: POST /worklog/:task_id { kind, content, agent?, title? } (GET variant: /worklog/:task_id/append)\nRead: GET /worklog/:task_id?format=json|md|text\nRecent across tasks: GET /worklog?limit=50&since=&task_id=\nList tasks: GET /worklog/list?status=active|completed|all&limit=20\nClose: POST /worklog/:task_id/close (GET variant exists)\nDelete: DELETE /worklog/:task_id (GET variant exists)\nkinds: start | progress | note | error | summary | close (unknown -> note)\nLimits: content max 256 KB per entry; agent max 128 chars; task_id [a-zA-Z0-9._/-] max 256.\nFleet rule (Michael #8882/#10509): POST /worklog at EVERY milestone — fix commit, verdict, escalation, handover, takeover, CRITICAL — not only at session end.\nUUID task_ids: append/create/close svarar 404 (task_not_found) när UUID:t inte har någon Synapse-uppgift (agent_tasks). Fria slugs kan fortfarande skapas fritt. (v1.39.46)\n","requestedLang":"sv","contentMarkdown":"\n# Worklog-API\n\nWorklogen är **den enda sanna källan för flottans arbetshistorik**. Den är append-only, per uppgift och sökbar. Medan `/memory` lagrar vad en agent *vet*, lagrar worklogen vad en agent *gjort* — som ett hållbart, granskbart spår per uppgift. Michaels stående regel (#8882, bekräftad i #10509): **push-first** — varje milstolpe får en post, så att en kraschad session aldrig förlorar sin historia och vilket syskon som helst kan fortsätta exakt där du slutade.\n\n## Begrepp\n\n| Term | Betydelse |\n| --- | --- |\n| Uppgiftsworklog | En namngiven logg identifierad av ett fritt `task_id` (ditt val: UUID-prefix, ärende-ID eller ärendelik slug). |\n| Post | En append-only-post: `kind`, `agent`, `content`, valfri `title`, tidsstämpel. |\n| Status | `active` (öppen) → `completed` (stängd) eller `abandoned`. Sätts via `/close`. |\n\n## Endpoints\n\nAlla endpoints är autentiserade (Mind Key eller användar-JWT) och avgränsade till anroparens mind — du ser aldrig andra minders workloggar.\n\n### Push — mönstret med ett anrop\n\nDen bekvämaste endpointen; lägger till en post och skapar uppgiftsposten om den saknas:\n\n```\nGET /worklog/push?task_id=run-145-ci-27&kind=progress&content=Pin-Fix pushed&agent=Janus\n```\n\n### Skapa / öppna en worklog\n\n```\nPOST /worklog\n{ \"task_id\": \"29140fb0-team-stats\", \"title\": \"Teamstatistik-verktyg\", \"agent\": \"Janus\" }\n```\n\nMed ett `content`-fält läggs den första posten till i samma anrop (svar `{{\"status\":\"appended\", ...}}`), annars skapas en tom uppgift (svar `{{\"status\":\"created\", ...}}`). GET-variant: `/worklog/create?task_id=...&title=...`.\n\n### Lägga till en post\n\n```\nPOST /worklog/29140fb0-team-stats\n{ \"kind\": \"progress\", \"content\": \"MR !29 skapad, pipeline kör\", \"agent\": \"Janus\" }\n```\n\nPosttyper (okända värden lagras som `note`):\n\n| kind | används för |\n| --- | --- |\n| `start` | uppgift tagen, arbetet börjar |\n| `progress` | milstolpe: commit, MR, utlåtande, testresultat |\n| `note` | kontext, beslut, iakttagelser |\n| `error` | fel inklusive vad du försökte (ditt framtida jag tackar) |\n| `summary` | fas/sessionssammanfattning före kontextöverlämning |\n| `close` | slutresultat; använd `/close`-endpointen för statusbytet |\n\nGränser: `content` ≤ 256 KB per post, `agent` ≤ 128 tecken.\n\n### Läsa\n\n```\nGET /worklog/29140fb0-team-stats?format=md\n```\n\n`format=json` (standard) returnerar uppgiftsposten + poster som strukturerad data, `md` renderar en läsbar markdown-transkription, `text` ren text.\n\n### Senaste aktivitet över uppgifter\n\n```\nGET /worklog?limit=50&since=1791565028\n```\n\nValfritt `task_id`-filter. `since` är en epoch-tidsstämpel i **sekunder**.\n\n### Lista uppgifter\n\n```\nGET /worklog/list?status=active&limit=20\n```\n\n### Stänga (och radera)\n\n```\nPOST /worklog/29140fb0-team-stats/close # status → slutförd\nDELETE /worklog/29140fb0-team-stats # tar bort hela uppgiftens worklog\n```\n\nBåda har GET-varianter (`/worklog/:task_id/close`, `/worklog/:task_id/delete`) för open-tool LLM-klienter. Stängning bevarar loggen — radering är den enda destruktiva operationen.\n\n## Rekommenderad rytm för agenter\n\n1. **`start`** — **`start`**-post när du tar en uppgift (bevis på claim).\n2. **`progress`** — **`progress`**-poster vid varje milstolpe — commit-SHA, MR-nummer, utlåtande, pipeline-status. Push-first (Michael #8882): inte bunta till sessionsslutet.\n3. **`error`** — **`error`**-poster för varje fel värt att minnas, med fixen.\n4. **`summary`** — **`summary`** innan kontexten tar slut — nästa run återupptar från state script + worklogen.\n5. **`close`** — **`close`** när uppgiften är klar (bevis i den sista posten).\n\nFlottövergripande uppgiftskonvention (`GET /script/fleet-worklog-tasks-spec`) bygger på detta API; guiden [Worklog för agenter](/docs/sv/guides/worklog-for-agents) innehåller ett kopiera-klistra-promptblock så att ingen agent \"glömmer\" funktionen (Michael #10509).\n\n## Task-ID-regler (v1.39.46)\n\n`task_id`:s i fullt UUID-format maste pa varje skrivvag (`POST /worklog`,\n`GET /worklog/create`, `GET /worklog/push`,\n`POST|GET /worklog/:task_id(/append|/close)`) referera en befintlig\nSynapse-uppgift (`agent_tasks`) — annars svarar endpointen\n`404 {\"error\":\"task_not_found\"}` med en ledtrad. Hallucinerade eller\navkapade UUID skapar inte langre tyst foraldlösa worklog-uppgifter. Fria,\nicke-UUID-id:n (`run-145-ci-27`, `morpheus-life`, prefix-slugs som\n`29140fb0-team-stats`) kan fortfarande skapas fritt (MEGA-1A-design).\nLas- och raderingsvagar ar oforandrade — de skapar aldrig nagot.\n","contentHtml":"

Worklog-API

\n

Worklogen är den enda sanna källan för flottans arbetshistorik. Den är append-only, per uppgift och sökbar. Medan /memory lagrar vad en agent vet, lagrar worklogen vad en agent gjort — som ett hållbart, granskbart spår per uppgift. Michaels stående regel (#8882, bekräftad i #10509): push-first — varje milstolpe får en post, så att en kraschad session aldrig förlorar sin historia och vilket syskon som helst kan fortsätta exakt där du slutade.

\n

Begrepp

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
TermBetydelse
UppgiftsworklogEn namngiven logg identifierad av ett fritt task_id (ditt val: UUID-prefix, ärende-ID eller ärendelik slug).
PostEn append-only-post: kind, agent, content, valfri title, tidsstämpel.
Statusactive (öppen) → completed (stängd) eller abandoned. Sätts via /close.
\n

Endpoints

\n

Alla endpoints är autentiserade (Mind Key eller användar-JWT) och avgränsade till anroparens mind — du ser aldrig andra minders workloggar.

\n

Push — mönstret med ett anrop

\n

Den bekvämaste endpointen; lägger till en post och skapar uppgiftsposten om den saknas:

\n
GET /worklog/push?task_id=run-145-ci-27&kind=progress&content=Pin-Fix pushed&agent=Janus

Skapa / öppna en worklog

\n
POST /worklog\n{ "task_id": "29140fb0-team-stats", "title": "Teamstatistik-verktyg", "agent": "Janus" }

Med ett content-fält läggs den första posten till i samma anrop (svar {{"status":"appended", ...}}), annars skapas en tom uppgift (svar {{"status":"created", ...}}). GET-variant: /worklog/create?task_id=...&title=....

\n

Lägga till en post

\n
POST /worklog/29140fb0-team-stats\n{ "kind": "progress", "content": "MR !29 skapad, pipeline kör", "agent": "Janus" }

Posttyper (okända värden lagras som note):

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
kindanvänds för
startuppgift tagen, arbetet börjar
progressmilstolpe: commit, MR, utlåtande, testresultat
notekontext, beslut, iakttagelser
errorfel inklusive vad du försökte (ditt framtida jag tackar)
summaryfas/sessionssammanfattning före kontextöverlämning
closeslutresultat; använd /close-endpointen för statusbytet
\n

Gränser: content ≤ 256 KB per post, agent ≤ 128 tecken.

\n

Läsa

\n
GET /worklog/29140fb0-team-stats?format=md

format=json (standard) returnerar uppgiftsposten + poster som strukturerad data, md renderar en läsbar markdown-transkription, text ren text.

\n

Senaste aktivitet över uppgifter

\n
GET /worklog?limit=50&since=1791565028

Valfritt task_id-filter. since är en epoch-tidsstämpel i sekunder.

\n

Lista uppgifter

\n
GET /worklog/list?status=active&limit=20

Stänga (och radera)

\n
POST /worklog/29140fb0-team-stats/close        # status → slutförd\nDELETE /worklog/29140fb0-team-stats            # tar bort hela uppgiftens worklog

Båda har GET-varianter (/worklog/:task_id/close, /worklog/:task_id/delete) för open-tool LLM-klienter. Stängning bevarar loggen — radering är den enda destruktiva operationen.

\n

Rekommenderad rytm för agenter

\n
    \n
  1. start — start-post när du tar en uppgift (bevis på claim).
    2. \n
  2. progress — progress-poster vid varje milstolpe — commit-SHA, MR-nummer, utlåtande, pipeline-status. Push-first (Michael #8882): inte bunta till sessionsslutet.
    3. \n
  3. error — error-poster för varje fel värt att minnas, med fixen.
    4. \n
  4. summary — summary innan kontexten tar slut — nästa run återupptar från state script + worklogen.
    5. \n
  5. close — close när uppgiften är klar (bevis i den sista posten).
    6. \n
\n

Flottövergripande uppgiftskonvention (GET /script/fleet-worklog-tasks-spec) bygger på detta API; guiden Worklog för agenter innehåller ett kopiera-klistra-promptblock så att ingen agent "glömmer" funktionen (Michael #10509).

\n

Task-ID-regler (v1.39.46)

\n

task_id:s i fullt UUID-format maste pa varje skrivvag (POST /worklog,\nGET /worklog/create, GET /worklog/push,\nPOST|GET /worklog/:task_id(/append|/close)) referera en befintlig\nSynapse-uppgift (agent_tasks) — annars svarar endpointen\n404 {"error":"task_not_found"} med en ledtrad. Hallucinerade eller\navkapade UUID skapar inte langre tyst foraldlösa worklog-uppgifter. Fria,\nicke-UUID-id:n (run-145-ci-27, morpheus-life, prefix-slugs som\n29140fb0-team-stats) kan fortfarande skapas fritt (MEGA-1A-design).\nLas- och raderingsvagar ar oforandrade — de skapar aldrig nagot.

\n","translationsAvailable":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}