Allt om tasks, från första kortet till API:t.

Workspace och medlemmar

Allt bor i en workspace: projekt, kort, dokument, nycklar och notiser. Du får en när du loggar in första gången, och kan äga upp till fem. Bjud in via Inställningar → Medlemmar; länken gäller sju dagar och kräver att den som klickar loggar in med samma e-post.

Roller: member ser och arbetar i tavlan, admin skapar projekt, nycklar och notiser, owner hanterar medlemmar, namn, export och radering. Delar ni e-postdomän med en befintlig workspace föreslås den vid inloggning och ägaren får godkänna.

Tavlan: kort, kolumner, typer

Ett kort har nyckel (INF-24), titel, beskrivning i markdown, status, prio 1–3, typ, etiketter och ansvarig. Statusarna är fasta i API:t — ny · accepterad · pagar · blockerad · vantar · klar · avvisad — men kolumnernas namn, färg och synlighet kan ändras per workspace eller projekt.

Kort kan ha subtasks som får ligga i andra projekt; föräldern visar hur många som är klara. Raderade kort hamnar i papperskorgen och kan återställas. Allt som händer loggas i flödet, märkt med vem eller vilken nyckel som gjorde det.

Dokument och mappar

Dokument är markdown med rubriknavigering, Mermaid-diagram och kortlänkar: skriv [INF-24] så blir det en länk med status. Ordna dem i mappar och koppla dem till projekt eller kort. Varje ändring sparas som revision.

Assistenten kan läsa och skriva dokument över MCP, så en runbook kan uppdateras direkt i samtalet.

Notiser till Discord och Slack

Under Inställningar → Notiser läggs en webhook-URL till Discord eller Slack in, globalt eller per projekt, för nya kort, statusbyten och kommentarer. URL:en visas aldrig igen. Klicka på kopplingen i sidomenyn för leveransstatus och en graf över utskicken.

Support och feedback

Buggar, önskemål, frågor och designtankar rapporteras från appen (Support i sidomenyn) eller via MCP-verktyget report_feedback. Ärendet blir ett kort hos tasks-teamet, du ser status och svar under Mina ärenden, och teamet kan svara direkt i tråden.

Assistent över MCP

tasks har en MCP-server inbyggd på https://tasks.nu/mcp (streamable HTTP, stateless). Skapa en API-nyckel i appen och lägg in den i klienten — verktygen beskriver sig själva, ingen kod behövs.

# Claude Code
claude mcp add --transport http tasks https://tasks.nu/mcp \
  --header "Authorization: Bearer tk_…"

# Claude Desktop, Cursor och andra: samma adress och header i klientens MCP-konfiguration
{ "mcpServers": { "tasks": { "url": "https://tasks.nu/mcp", "headers": { "Authorization": "Bearer tk_…" } } } }

Nyckeln räknas som admin i workspacen: den kan skapa projekt, kort och dokument men aldrig röra medlemmar, inställningar eller andra nycklar. Klicka på MCP i sidomenyn för att se vad assistenten gjort, per timme.

REST: kom igång på fem minuter

1. 1Skapa en API-nyckel

   I appen: Inställningar → API-nycklar. Nyckeln visas en gång och lagras hashad. Samma nyckel fungerar för MCP och REST.

2. 2Skicka den som Bearer

   Authorization: Bearer tk_… på varje anrop. JSON in, JSON ut, tider i RFC 3339. Alla adresser börjar på https://tasks.nu/api.

3. 3Skapa ett kort och se det på tavlan

   Exemplet högst upp. Kortet dyker upp direkt, märkt med nyckelns namn i flödet så det syns varifrån det kom.

Webhooks

Vill du reagera när något händer i ett projekt: registrera en URL med POST /api/projects/{slug}/webhooks. Vid varje händelse på projektets kort skickas en JSON-kropp med händelse, kort och vem som gjorde det. Anger du en secret signeras kroppen med HMAC-SHA256 i headern X-Tasks-Signature.

För Discord och Slack finns färdiga notiskopplingar i appen — de behöver ingen kod alls.

Fel och gränser

Fel svarar med en JSON-kropp {"error": "…"} och en 4xx-status: 400 fel i anropet, 401 saknad eller ogiltig nyckel, 403 för låg roll, 404 finns inte, 409 krock (slug eller nyckel upptagen), 429 för många anrop.

Gränserna räknas per instans av API:t. 429 kommer med Retry-After: 60.

MCP eller REST?

Specen finns som OpenAPI 3.1 för generatorer och klienter. Driftläget syns på status.tasks.nu. Saknar du något: hör av dig eller rapportera från appen.