{"openapi":"3.1.0","info":{"title":"Atlas API","version":"1.0.0","description":"Boards, categories, tags, todos, history and import/export. Authenticate with an API key or an OAuth 2.0 access token."},"servers":[{"url":"https://atlas.s8n.xyz"}],"tags":[{"name":"Account"},{"name":"Boards"},{"name":"Categories"},{"name":"Tags"},{"name":"Todos"},{"name":"History"},{"name":"Import & export"}],"paths":{"/api/v1/me":{"get":{"operationId":"me_get","tags":["Account"],"summary":"Get the current user","description":"Returns the user the credential belongs to. OAuth apps use this to identify who authorised them.","parameters":[],"security":[{"apiKey":[]},{"oauth2":["identify"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":{"id":"80351110224678912","username":"nelly","globalName":"Nelly","avatarUrl":"https://cdn.discordapp.com/avatars/80351110224678912/abc.png?size=128","createdAt":"2026-09-01T10:00:00.000Z"}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}},"/api/v1/boards":{"get":{"operationId":"boards_list","tags":["Boards"],"summary":"List boards","description":"Boards sorted by position, including todo counts per state and per category.","parameters":[{"name":"counts","in":"query","required":false,"description":"Set to false to skip counting todos (faster)","schema":{"type":"boolean"}},{"name":"archived","in":"query","required":false,"description":"Include archived boards","schema":{"type":"boolean"}}],"security":[{"apiKey":[]},{"oauth2":["boards:read"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":[{"id":"1291204012871098368","userId":"80351110224678912","name":"Website redesign","description":"Everything for the Q4 relaunch","icon":"lucide:layout-dashboard","color":"#7c5cff","position":1024,"categories":[{"id":"1291204012871098370","name":"Backlog","icon":"lucide:inbox","color":"#71717a"},{"id":"1291204012871098369","name":"Up next","icon":"lucide:arrow-right-circle","color":"#7c5cff"}],"tags":[{"id":"1291204012871098371","name":"Bug","icon":"lucide:bug","color":"#ef4444"}],"archived":false,"createdAt":"2026-10-01T12:00:00.000Z","updatedAt":"2026-10-05T09:30:00.000Z","counts":{"active":8,"completed":21,"scrapped":2,"deleted":1,"byCategory":{"1291204012871098369":3,"1291204012871098370":5}}}]}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}},"post":{"operationId":"boards_create","tags":["Boards"],"summary":"Create a board","description":"New boards start with Backlog / Important / Up next / In progress / Pending categories and a few tags unless template is \"empty\".","parameters":[],"security":[{"apiKey":[]},{"oauth2":["boards:write"]}],"responses":{"201":{"description":"Success","content":{"application/json":{"example":{"data":{"id":"1291204012871098368","userId":"80351110224678912","name":"Website redesign","description":"Everything for the Q4 relaunch","icon":"lucide:layout-dashboard","color":"#7c5cff","position":1024,"categories":[{"id":"1291204012871098370","name":"Backlog","icon":"lucide:inbox","color":"#71717a"},{"id":"1291204012871098369","name":"Up next","icon":"lucide:arrow-right-circle","color":"#7c5cff"}],"tags":[{"id":"1291204012871098371","name":"Bug","icon":"lucide:bug","color":"#ef4444"}],"archived":false,"createdAt":"2026-10-01T12:00:00.000Z","updatedAt":"2026-10-05T09:30:00.000Z"}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"description":"1–60 characters","type":"string"},"description":{"description":"Up to 500 characters","type":"string"},"icon":{"description":"\"lucide:<icon-name>\", a single emoji, an image URL (https://…), \"site-icon:example.com\" (that site's favicon), or an empty string","type":"string"},"color":{"description":"Hex colour like #7c5cff","type":"string"},"template":{"description":"default · empty","type":"string"}}},"example":{"name":"Website redesign","description":"Everything for the Q4 relaunch","icon":"lucide:layout-dashboard","color":"#7c5cff"}}}}}},"/api/v1/boards/{boardId}":{"get":{"operationId":"boards_get","tags":["Boards"],"summary":"Get a board","parameters":[{"name":"boardId","in":"path","required":true,"description":"Board id","schema":{"type":"string"}},{"name":"counts","in":"query","required":false,"description":"Include todo counts (default true)","schema":{"type":"boolean"}}],"security":[{"apiKey":[]},{"oauth2":["boards:read"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":{"id":"1291204012871098368","userId":"80351110224678912","name":"Website redesign","description":"Everything for the Q4 relaunch","icon":"lucide:layout-dashboard","color":"#7c5cff","position":1024,"categories":[{"id":"1291204012871098370","name":"Backlog","icon":"lucide:inbox","color":"#71717a"},{"id":"1291204012871098369","name":"Up next","icon":"lucide:arrow-right-circle","color":"#7c5cff"}],"tags":[{"id":"1291204012871098371","name":"Bug","icon":"lucide:bug","color":"#ef4444"}],"archived":false,"createdAt":"2026-10-01T12:00:00.000Z","updatedAt":"2026-10-05T09:30:00.000Z"}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}},"patch":{"operationId":"boards_update","tags":["Boards"],"summary":"Update a board","parameters":[{"name":"boardId","in":"path","required":true,"description":"Board id","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"oauth2":["boards:update"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":{"id":"1291204012871098368","userId":"80351110224678912","name":"Website redesign","description":"Everything for the Q4 relaunch","icon":"lucide:layout-dashboard","color":"#7c5cff","position":1024,"categories":[{"id":"1291204012871098370","name":"Backlog","icon":"lucide:inbox","color":"#71717a"},{"id":"1291204012871098369","name":"Up next","icon":"lucide:arrow-right-circle","color":"#7c5cff"}],"tags":[{"id":"1291204012871098371","name":"Bug","icon":"lucide:bug","color":"#ef4444"}],"archived":false,"createdAt":"2026-10-01T12:00:00.000Z","updatedAt":"2026-10-05T09:30:00.000Z"}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"description":"1–60 characters","type":"string"},"description":{"description":"Up to 500 characters","type":"string"},"icon":{"description":"\"lucide:<icon-name>\", a single emoji, an image URL (https://…), \"site-icon:example.com\" (that site's favicon), or an empty string","type":"string"},"color":{"description":"Hex colour","type":"string"},"archived":{"description":"Archive / unarchive","type":"boolean"}}},"example":{"name":"Website relaunch"}}}}},"delete":{"operationId":"boards_delete","tags":["Boards"],"summary":"Delete a board","description":"Permanently deletes the board with all of its todos and history. This cannot be undone.","parameters":[{"name":"boardId","in":"path","required":true,"description":"Board id","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"oauth2":["boards:delete"]}],"responses":{"204":{"description":"No content"},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}},"/api/v1/boards/reorder":{"put":{"operationId":"boards_reorder","tags":["Boards"],"summary":"Reorder boards","parameters":[],"security":[{"apiKey":[]},{"oauth2":["boards:update"]}],"responses":{"204":{"description":"No content"},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["ids"],"properties":{"ids":{"description":"Board ids in the desired order","type":"array","items":{"type":"string"}}}},"example":{"ids":["1291204012871098368"]}}}}}},"/api/v1/boards/{boardId}/categories":{"post":{"operationId":"categories_create","tags":["Categories"],"summary":"Create a category","description":"Categories are the lists (columns) of a board. Each has its own name, icon and colour.","parameters":[{"name":"boardId","in":"path","required":true,"description":"Board id","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"oauth2":["boards:write"]}],"responses":{"201":{"description":"Success","content":{"application/json":{"example":{"data":{"id":"1291204012871098369","name":"Up next","icon":"lucide:arrow-right-circle","color":"#7c5cff"}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"description":"1–60 characters, unique per board","type":"string"},"icon":{"description":"\"lucide:<icon-name>\", a single emoji, an image URL (https://…), \"site-icon:example.com\" (that site's favicon), or an empty string","type":"string"},"color":{"description":"Hex colour","type":"string"}}},"example":{"name":"Review","icon":"🔍","color":"#06b6d4"}}}}}},"/api/v1/boards/{boardId}/categories/{categoryId}":{"patch":{"operationId":"categories_update","tags":["Categories"],"summary":"Update a category","parameters":[{"name":"boardId","in":"path","required":true,"description":"Board id","schema":{"type":"string"}},{"name":"categoryId","in":"path","required":true,"description":"Category id","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"oauth2":["boards:update"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":{"id":"1291204012871098369","name":"Up next","icon":"lucide:arrow-right-circle","color":"#7c5cff"}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"description":"New name","type":"string"},"icon":{"description":"\"lucide:<icon-name>\", a single emoji, an image URL (https://…), \"site-icon:example.com\" (that site's favicon), or an empty string","type":"string"},"color":{"description":"Hex colour","type":"string"}}},"example":{"color":"#22c55e"}}}}},"delete":{"operationId":"categories_delete","tags":["Categories"],"summary":"Delete a category","description":"Todos (including history) are moved to `moveTo`, or to the first remaining category. A board always keeps at least one category.","parameters":[{"name":"boardId","in":"path","required":true,"description":"Board id","schema":{"type":"string"}},{"name":"categoryId","in":"path","required":true,"description":"Category id","schema":{"type":"string"}},{"name":"moveTo","in":"query","required":false,"description":"Category that receives the todos","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"oauth2":["boards:delete"]}],"responses":{"204":{"description":"No content"},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}},"/api/v1/boards/{boardId}/categories/order":{"put":{"operationId":"categories_order","tags":["Categories"],"summary":"Reorder categories","parameters":[{"name":"boardId","in":"path","required":true,"description":"Board id","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"oauth2":["boards:update"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":[{"id":"1291204012871098369","name":"Up next","icon":"lucide:arrow-right-circle","color":"#7c5cff"}]}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["ids"],"properties":{"ids":{"description":"Category ids in the desired order","type":"array","items":{"type":"string"}}}},"example":{"ids":["1291204012871098369","1291204012871098370"]}}}}}},"/api/v1/boards/{boardId}/tags":{"post":{"operationId":"tags_create","tags":["Tags"],"summary":"Create a tag","parameters":[{"name":"boardId","in":"path","required":true,"description":"Board id","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"oauth2":["boards:write"]}],"responses":{"201":{"description":"Success","content":{"application/json":{"example":{"data":{"id":"1291204012871098371","name":"Bug","icon":"lucide:bug","color":"#ef4444"}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"description":"1–60 characters, unique per board","type":"string"},"icon":{"description":"\"lucide:<icon-name>\", a single emoji, an image URL (https://…), \"site-icon:example.com\" (that site's favicon), or an empty string","type":"string"},"color":{"description":"Hex colour","type":"string"}}},"example":{"name":"Bug","icon":"lucide:bug","color":"#ef4444"}}}}}},"/api/v1/boards/{boardId}/tags/{tagId}":{"patch":{"operationId":"tags_update","tags":["Tags"],"summary":"Update a tag","parameters":[{"name":"boardId","in":"path","required":true,"description":"Board id","schema":{"type":"string"}},{"name":"tagId","in":"path","required":true,"description":"Tag id","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"oauth2":["boards:update"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":{"id":"1291204012871098371","name":"Bug","icon":"lucide:bug","color":"#ef4444"}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"name":{"description":"New name","type":"string"},"icon":{"description":"\"lucide:<icon-name>\", a single emoji, an image URL (https://…), \"site-icon:example.com\" (that site's favicon), or an empty string","type":"string"},"color":{"description":"Hex colour","type":"string"}}},"example":{"name":"Defect"}}}}},"delete":{"operationId":"tags_delete","tags":["Tags"],"summary":"Delete a tag","description":"The tag is removed from every todo that used it.","parameters":[{"name":"boardId","in":"path","required":true,"description":"Board id","schema":{"type":"string"}},{"name":"tagId","in":"path","required":true,"description":"Tag id","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"oauth2":["boards:delete"]}],"responses":{"204":{"description":"No content"},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}},"/api/v1/boards/{boardId}/tags/order":{"put":{"operationId":"tags_order","tags":["Tags"],"summary":"Reorder tags","parameters":[{"name":"boardId","in":"path","required":true,"description":"Board id","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"oauth2":["boards:update"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":[{"id":"1291204012871098371","name":"Bug","icon":"lucide:bug","color":"#ef4444"}]}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["ids"],"properties":{"ids":{"description":"Tag ids in the desired order","type":"array","items":{"type":"string"}}}},"example":{"ids":["1291204012871098371"]}}}}}},"/api/v1/boards/{boardId}/todos":{"get":{"operationId":"todos_list","tags":["Todos"],"summary":"List todos","description":"By default only active todos are returned – completed, scrapped and deleted todos only exist in History (state=history).","parameters":[{"name":"boardId","in":"path","required":true,"description":"Board id","schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"active (default) · history · completed · scrapped · deleted · all","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Only todos in this category","schema":{"type":"string"}},{"name":"tag","in":"query","required":false,"description":"Only todos with this tag","schema":{"type":"string"}},{"name":"priority","in":"query","required":false,"description":"none · low · medium · high · urgent","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Search title/description, or a todo number like #12","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"position · created · updated · state_changed · priority · due","schema":{"type":"string"}},{"name":"order","in":"query","required":false,"description":"asc · desc","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1–500 (default 100, active lists default to 2000)","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Skip this many results","schema":{"type":"integer"}}],"security":[{"apiKey":[]},{"oauth2":["todos:read"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":[{"id":"1291204188272291840","userId":"80351110224678912","boardId":"1291204012871098368","number":12,"categoryId":"1291204012871098369","tagIds":["1291204012871098371"],"attachments":["https://example.com/screenshots/safari-loop.png"],"title":"Fix **login redirect** loop","description":"Steps to reproduce:\n\n1. Sign out\n2. Open `/boards`\n\n:bug: Happens on Safari only.","priority":"high","dueAt":"2026-10-12T00:00:00.000Z","position":2048,"state":"active","stateNote":null,"stateChangedAt":null,"createdAt":"2026-10-05T09:30:00.000Z","updatedAt":"2026-10-05T09:30:00.000Z","createdVia":"web"}],"meta":{"total":1,"hasMore":false}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}},"post":{"operationId":"todos_create","tags":["Todos"],"summary":"Create a todo","description":"`title` supports inline markdown, `description` supports full markdown (links, colours, code blocks, emoji, headers, images…).","parameters":[{"name":"boardId","in":"path","required":true,"description":"Board id","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"oauth2":["todos:write"]}],"responses":{"201":{"description":"Success","content":{"application/json":{"example":{"data":{"id":"1291204188272291840","userId":"80351110224678912","boardId":"1291204012871098368","number":12,"categoryId":"1291204012871098369","tagIds":["1291204012871098371"],"attachments":["https://example.com/screenshots/safari-loop.png"],"title":"Fix **login redirect** loop","description":"Steps to reproduce:\n\n1. Sign out\n2. Open `/boards`\n\n:bug: Happens on Safari only.","priority":"high","dueAt":"2026-10-12T00:00:00.000Z","position":2048,"state":"active","stateNote":null,"stateChangedAt":null,"createdAt":"2026-10-05T09:30:00.000Z","updatedAt":"2026-10-05T09:30:00.000Z","createdVia":"web"}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title"],"properties":{"title":{"description":"1–300 characters","type":"string"},"description":{"description":"Markdown, up to 20,000 characters","type":"string"},"categoryId":{"description":"Defaults to the first category","type":"string"},"tagIds":{"description":"Up to 20 tags of this board","type":"array","items":{"type":"string"}},"attachments":{"description":"Up to 10 image URLs (http/https), shown in the todo viewer","type":"array","items":{"type":"string"}},"priority":{"description":"none · low · medium · high · urgent","type":"string"},"dueAt":{"description":"Due date","type":"string"},"top":{"description":"Insert at the top instead of the bottom","type":"boolean"}}},"example":{"title":"Fix **login redirect** loop","description":"Happens on Safari only :bug:","categoryId":"1291204012871098369","tagIds":["1291204012871098371"],"priority":"high","dueAt":"2026-10-12T00:00:00.000Z"}}}}}},"/api/v1/todos/{todoId}":{"get":{"operationId":"todos_get","tags":["Todos"],"summary":"Get a todo","parameters":[{"name":"todoId","in":"path","required":true,"description":"Todo id","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"oauth2":["todos:read"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":{"id":"1291204188272291840","userId":"80351110224678912","boardId":"1291204012871098368","number":12,"categoryId":"1291204012871098369","tagIds":["1291204012871098371"],"attachments":["https://example.com/screenshots/safari-loop.png"],"title":"Fix **login redirect** loop","description":"Steps to reproduce:\n\n1. Sign out\n2. Open `/boards`\n\n:bug: Happens on Safari only.","priority":"high","dueAt":"2026-10-12T00:00:00.000Z","position":2048,"state":"active","stateNote":null,"stateChangedAt":null,"createdAt":"2026-10-05T09:30:00.000Z","updatedAt":"2026-10-05T09:30:00.000Z","createdVia":"web"}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}},"patch":{"operationId":"todos_update","tags":["Todos"],"summary":"Edit a todo","description":"Changing `categoryId` moves the todo to the bottom of that category. Use the move endpoint for precise placement.","parameters":[{"name":"todoId","in":"path","required":true,"description":"Todo id","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"oauth2":["todos:update"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":{"id":"1291204188272291840","userId":"80351110224678912","boardId":"1291204012871098368","number":12,"categoryId":"1291204012871098369","tagIds":["1291204012871098371"],"attachments":["https://example.com/screenshots/safari-loop.png"],"title":"Fix **login redirect** loop","description":"Steps to reproduce:\n\n1. Sign out\n2. Open `/boards`\n\n:bug: Happens on Safari only.","priority":"urgent","dueAt":"2026-10-12T00:00:00.000Z","position":2048,"state":"active","stateNote":null,"stateChangedAt":null,"createdAt":"2026-10-05T09:30:00.000Z","updatedAt":"2026-10-05T09:30:00.000Z","createdVia":"web"}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"title":{"description":"1–300 characters","type":"string"},"description":{"description":"Markdown","type":"string"},"categoryId":{"description":"Move to another category","type":"string"},"tagIds":{"description":"Replaces all tags","type":"array","items":{"type":"string"}},"attachments":{"description":"Replaces all image URLs (max 10)","type":"array","items":{"type":"string"}},"priority":{"description":"none · low · medium · high · urgent","type":"string"},"dueAt":{"description":"Set or clear the due date","type":"string"}}},"example":{"priority":"urgent"}}}}},"delete":{"operationId":"todos_delete","tags":["Todos"],"summary":"Delete a todo","description":"Soft delete: the todo moves to History as \"deleted\" and can be restored. Add `?permanent=true` to remove a todo that is already in History for good.","parameters":[{"name":"todoId","in":"path","required":true,"description":"Todo id","schema":{"type":"string"}},{"name":"permanent","in":"query","required":false,"description":"Permanently delete a history item (responds 204)","schema":{"type":"boolean"}},{"name":"note","in":"query","required":false,"description":"Optional note","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"oauth2":["todos:delete"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":{"id":"1291204188272291840","userId":"80351110224678912","boardId":"1291204012871098368","number":12,"categoryId":"1291204012871098369","tagIds":["1291204012871098371"],"attachments":["https://example.com/screenshots/safari-loop.png"],"title":"Fix **login redirect** loop","description":"Steps to reproduce:\n\n1. Sign out\n2. Open `/boards`\n\n:bug: Happens on Safari only.","priority":"high","dueAt":"2026-10-12T00:00:00.000Z","position":2048,"state":"deleted","stateNote":null,"stateChangedAt":"2026-10-06T08:00:00.000Z","createdAt":"2026-10-05T09:30:00.000Z","updatedAt":"2026-10-05T09:30:00.000Z","createdVia":"web"}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}},"/api/v1/todos/{todoId}/move":{"post":{"operationId":"todos_move","tags":["Todos"],"summary":"Move a todo","description":"Place the todo between two neighbours of the target category. Send `afterId` (the todo that will be above it) and/or `beforeId` (the one below it). With neither, it goes to the bottom (or the top with `top: true`).","parameters":[{"name":"todoId","in":"path","required":true,"description":"Todo id","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"oauth2":["todos:update"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":{"id":"1291204188272291840","userId":"80351110224678912","boardId":"1291204012871098368","number":12,"categoryId":"1291204012871098369","tagIds":["1291204012871098371"],"attachments":["https://example.com/screenshots/safari-loop.png"],"title":"Fix **login redirect** loop","description":"Steps to reproduce:\n\n1. Sign out\n2. Open `/boards`\n\n:bug: Happens on Safari only.","priority":"high","dueAt":"2026-10-12T00:00:00.000Z","position":2048,"state":"active","stateNote":null,"stateChangedAt":null,"createdAt":"2026-10-05T09:30:00.000Z","updatedAt":"2026-10-05T09:30:00.000Z","createdVia":"web"}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"categoryId":{"description":"Target category (defaults to the current one)","type":"string"},"afterId":{"description":"Todo that will sit directly above","type":"string"},"beforeId":{"description":"Todo that will sit directly below","type":"string"},"top":{"description":"Place at the top when no neighbours are given","type":"boolean"}}},"example":{"categoryId":"1291204012871098369","afterId":"1291204193917657088"}}}}}},"/api/v1/todos/{todoId}/complete":{"post":{"operationId":"todos_complete","tags":["Todos"],"summary":"Complete a todo","description":"Moves the todo out of the board into History as \"completed\". It can be restored later.","parameters":[{"name":"todoId","in":"path","required":true,"description":"Todo id","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"oauth2":["todos:update"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":{"id":"1291204188272291840","userId":"80351110224678912","boardId":"1291204012871098368","number":12,"categoryId":"1291204012871098369","tagIds":["1291204012871098371"],"attachments":["https://example.com/screenshots/safari-loop.png"],"title":"Fix **login redirect** loop","description":"Steps to reproduce:\n\n1. Sign out\n2. Open `/boards`\n\n:bug: Happens on Safari only.","priority":"high","dueAt":"2026-10-12T00:00:00.000Z","position":2048,"state":"completed","stateNote":"Shipped in v2.4","stateChangedAt":"2026-10-06T08:00:00.000Z","createdAt":"2026-10-05T09:30:00.000Z","updatedAt":"2026-10-05T09:30:00.000Z","createdVia":"web"}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"note":{"description":"Optional note (max 500 chars) stored with the history entry","type":"string"}}},"example":{"note":"Shipped in v2.4"}}}}}},"/api/v1/todos/{todoId}/scrap":{"post":{"operationId":"todos_scrap","tags":["Todos"],"summary":"Scrap a todo","description":"Moves the todo out of the board into History as \"scrapped\". It can be restored later.","parameters":[{"name":"todoId","in":"path","required":true,"description":"Todo id","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"oauth2":["todos:update"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":{"id":"1291204188272291840","userId":"80351110224678912","boardId":"1291204012871098368","number":12,"categoryId":"1291204012871098369","tagIds":["1291204012871098371"],"attachments":["https://example.com/screenshots/safari-loop.png"],"title":"Fix **login redirect** loop","description":"Steps to reproduce:\n\n1. Sign out\n2. Open `/boards`\n\n:bug: Happens on Safari only.","priority":"high","dueAt":"2026-10-12T00:00:00.000Z","position":2048,"state":"scrapped","stateNote":"No longer needed","stateChangedAt":"2026-10-06T08:00:00.000Z","createdAt":"2026-10-05T09:30:00.000Z","updatedAt":"2026-10-05T09:30:00.000Z","createdVia":"web"}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"note":{"description":"Optional note (max 500 chars) stored with the history entry","type":"string"}}},"example":{"note":"No longer needed"}}}}}},"/api/v1/todos/{todoId}/restore":{"post":{"operationId":"todos_restore","tags":["Todos"],"summary":"Restore a todo","description":"Brings a completed, scrapped or deleted todo back to its category (or the first category if it was removed).","parameters":[{"name":"todoId","in":"path","required":true,"description":"Todo id","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"oauth2":["todos:update"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":{"id":"1291204188272291840","userId":"80351110224678912","boardId":"1291204012871098368","number":12,"categoryId":"1291204012871098369","tagIds":["1291204012871098371"],"attachments":["https://example.com/screenshots/safari-loop.png"],"title":"Fix **login redirect** loop","description":"Steps to reproduce:\n\n1. Sign out\n2. Open `/boards`\n\n:bug: Happens on Safari only.","priority":"high","dueAt":"2026-10-12T00:00:00.000Z","position":2048,"state":"active","stateNote":null,"stateChangedAt":null,"createdAt":"2026-10-05T09:30:00.000Z","updatedAt":"2026-10-05T09:30:00.000Z","createdVia":"web"}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}},"/api/v1/todos/{todoId}/events":{"get":{"operationId":"todos_events","tags":["Todos"],"summary":"Todo activity","parameters":[{"name":"todoId","in":"path","required":true,"description":"Todo id","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max 200","schema":{"type":"integer"}}],"security":[{"apiKey":[]},{"oauth2":["todos:read"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":[{"id":"1291204300000000000","todoId":"1291204188272291840","boardId":"1291204012871098368","type":"moved","data":{"from":"1291204012871098370","to":"1291204012871098369"},"actor":"web","at":"2026-10-05T10:00:00.000Z"}]}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}},"/api/v1/todos/bulk":{"post":{"operationId":"todos_bulk","tags":["Todos"],"summary":"Bulk actions","description":"Apply an action to up to 200 todos: move, complete, scrap, delete, restore, purge (permanent, history only), tag or priority. move/tag/priority require todos from one board. `delete` and `purge` need `todos:delete`; all other actions need `todos:update`.","parameters":[],"security":[{"apiKey":[]},{"oauth2":["todos:update"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":{"affected":2,"items":[{"id":"1291204188272291840","userId":"80351110224678912","boardId":"1291204012871098368","number":12,"categoryId":"1291204012871098369","tagIds":["1291204012871098371"],"attachments":["https://example.com/screenshots/safari-loop.png"],"title":"Fix **login redirect** loop","description":"Steps to reproduce:\n\n1. Sign out\n2. Open `/boards`\n\n:bug: Happens on Safari only.","priority":"high","dueAt":"2026-10-12T00:00:00.000Z","position":2048,"state":"active","stateNote":null,"stateChangedAt":null,"createdAt":"2026-10-05T09:30:00.000Z","updatedAt":"2026-10-05T09:30:00.000Z","createdVia":"web"}]}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["ids","action"],"properties":{"ids":{"description":"Todo ids","type":"array","items":{"type":"string"}},"action":{"description":"move · complete · scrap · delete · restore · purge · tag · priority","type":"string"},"categoryId":{"description":"For move","type":"string"},"addTagIds":{"description":"For tag","type":"array","items":{"type":"string"}},"removeTagIds":{"description":"For tag","type":"array","items":{"type":"string"}},"priority":{"description":"For priority","type":"string"},"note":{"description":"For complete / scrap / delete","type":"string"}}},"example":{"ids":["1291204188272291840","1291204193917657088"],"action":"complete","note":"Sprint 14"}}}}}},"/api/v1/boards/{boardId}/history":{"get":{"operationId":"history_list","tags":["History"],"summary":"List history","description":"Completed, scrapped and deleted todos, newest first. Filter with state=completed|scrapped|deleted. Paginated: use `limit` (1–500, default 100) and `offset`; `meta.total` is the number of matching entries and `meta.hasMore` tells you whether another page exists.","parameters":[{"name":"boardId","in":"path","required":true,"description":"Board id","schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"active (default) · history · completed · scrapped · deleted · all","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Only todos in this category","schema":{"type":"string"}},{"name":"tag","in":"query","required":false,"description":"Only todos with this tag","schema":{"type":"string"}},{"name":"priority","in":"query","required":false,"description":"none · low · medium · high · urgent","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Search title/description, or a todo number like #12","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"position · created · updated · state_changed · priority · due","schema":{"type":"string"}},{"name":"order","in":"query","required":false,"description":"asc · desc","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1–500 (default 100, active lists default to 2000)","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Skip this many results","schema":{"type":"integer"}}],"security":[{"apiKey":[]},{"oauth2":["todos:read"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":[{"id":"1291204188272291840","userId":"80351110224678912","boardId":"1291204012871098368","number":12,"categoryId":"1291204012871098369","tagIds":["1291204012871098371"],"attachments":["https://example.com/screenshots/safari-loop.png"],"title":"Fix **login redirect** loop","description":"Steps to reproduce:\n\n1. Sign out\n2. Open `/boards`\n\n:bug: Happens on Safari only.","priority":"high","dueAt":"2026-10-12T00:00:00.000Z","position":2048,"state":"completed","stateNote":null,"stateChangedAt":"2026-10-06T08:00:00.000Z","createdAt":"2026-10-05T09:30:00.000Z","updatedAt":"2026-10-05T09:30:00.000Z","createdVia":"web"}],"meta":{"total":1,"hasMore":false}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}},"delete":{"operationId":"history_purge","tags":["History"],"summary":"Empty history","description":"Permanently deletes history entries. Defaults to deleted todos only.","parameters":[{"name":"boardId","in":"path","required":true,"description":"Board id","schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"completed · scrapped · deleted (default) · all","schema":{"type":"string"}}],"security":[{"apiKey":[]},{"oauth2":["todos:delete"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":{"removed":3}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}},"/api/v1/export":{"get":{"operationId":"export_all","tags":["Import & export"],"summary":"Export boards","description":"A portable JSON document with every board (or only ?boards=id1,id2), including categories, tags and history. Feed it back to POST /import.","parameters":[{"name":"boards","in":"query","required":false,"description":"Comma separated board ids (default: all)","schema":{"type":"string"}},{"name":"history","in":"query","required":false,"description":"false leaves out completed/scrapped/deleted","schema":{"type":"boolean"}},{"name":"download","in":"query","required":false,"description":"Adds a Content-Disposition header","schema":{"type":"boolean"}}],"security":[{"apiKey":[]},{"oauth2":["data:export"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"format":"atlas.export","version":1,"exportedAt":"2026-10-06T08:00:00.000Z","includeHistory":true,"boards":[{"id":"1291204012871098368","userId":"80351110224678912","name":"Website redesign","description":"Everything for the Q4 relaunch","icon":"lucide:layout-dashboard","color":"#7c5cff","position":1024,"categories":[{"id":"1291204012871098370","name":"Backlog","icon":"lucide:inbox","color":"#71717a"},{"id":"1291204012871098369","name":"Up next","icon":"lucide:arrow-right-circle","color":"#7c5cff"}],"tags":[{"id":"1291204012871098371","name":"Bug","icon":"lucide:bug","color":"#ef4444"}],"archived":false,"createdAt":"2026-10-01T12:00:00.000Z","updatedAt":"2026-10-05T09:30:00.000Z","todos":[{"id":"1291204188272291840","number":12,"title":"Fix **login redirect** loop","description":"Steps to reproduce:\n\n1. Sign out\n2. Open `/boards`\n\n:bug: Happens on Safari only.","categoryId":"1291204012871098369","tagIds":["1291204012871098371"],"priority":"high","dueAt":null,"position":2048,"state":"active","stateNote":null,"stateChangedAt":null,"createdAt":"2026-10-05T09:30:00.000Z","updatedAt":"2026-10-05T09:30:00.000Z"}]}]}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}},"/api/v1/boards/{boardId}/export":{"get":{"operationId":"export_board","tags":["Import & export"],"summary":"Export one board","parameters":[{"name":"boardId","in":"path","required":true,"description":"Board id","schema":{"type":"string"}},{"name":"history","in":"query","required":false,"description":"false leaves out history","schema":{"type":"boolean"}},{"name":"download","in":"query","required":false,"description":"Adds a Content-Disposition header","schema":{"type":"boolean"}}],"security":[{"apiKey":[]},{"oauth2":["data:export"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"format":"atlas.export","version":1,"exportedAt":"2026-10-06T08:00:00.000Z","includeHistory":true,"boards":[{"id":"1291204012871098368","userId":"80351110224678912","name":"Website redesign","description":"Everything for the Q4 relaunch","icon":"lucide:layout-dashboard","color":"#7c5cff","position":1024,"categories":[{"id":"1291204012871098370","name":"Backlog","icon":"lucide:inbox","color":"#71717a"},{"id":"1291204012871098369","name":"Up next","icon":"lucide:arrow-right-circle","color":"#7c5cff"}],"tags":[{"id":"1291204012871098371","name":"Bug","icon":"lucide:bug","color":"#ef4444"}],"archived":false,"createdAt":"2026-10-01T12:00:00.000Z","updatedAt":"2026-10-05T09:30:00.000Z","todos":[]}]}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}},"/api/v1/import":{"post":{"operationId":"import","tags":["Import & export"],"summary":"Import boards","description":"Accepts an export file from this site or a legacy todo.json (`items` array). Modes: `create` (always new boards), `merge` (match boards/todos by id and update, add the rest) and `replace` (like merge, but todos missing from the file are permanently removed). Always preview with `dryRun: true`. Completed and scrapped todos are imported into History.","parameters":[],"security":[{"apiKey":[]},{"oauth2":["data:import"]}],"responses":{"200":{"description":"Success","content":{"application/json":{"example":{"data":{"dryRun":true,"mode":"merge","boards":{"added":[],"updated":["Website redesign"],"unchanged":[]},"todos":{"added":["Fix login redirect loop"],"updated":[],"unchanged":[],"removed":[],"invalid":[]},"warnings":[]}}}}},"400":{"description":"Validation error"},"401":{"description":"Unauthorized"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["data"],"properties":{"data":{"description":"The export document","type":"object"},"mode":{"description":"create (default) · merge · replace","type":"string"},"dryRun":{"description":"Report what would change without writing","type":"boolean"},"targetBoardId":{"description":"Import a single-board file into an existing board","type":"string"},"boardName":{"description":"Name for the board created from a legacy file","type":"string"}}},"example":{"mode":"merge","dryRun":true,"data":{"format":"atlas.export","version":1,"boards":[]}}}}}}}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"API key created at /developers/keys (plk_…)"},"oauth2":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://atlas.s8n.xyz/oauth/authorize","tokenUrl":"https://atlas.s8n.xyz/api/oauth/token","refreshUrl":"https://atlas.s8n.xyz/api/oauth/token","scopes":{"identify":"Read your basic profile (id, username, avatar)","boards:read":"Read your boards, categories and tags","boards:write":"Create boards, categories and tags","boards:update":"Edit and reorder boards, categories and tags","boards:delete":"Delete boards, categories and tags","todos:read":"Read todos and the todo history","todos:write":"Create todos","todos:update":"Edit, move, complete, scrap and restore todos","todos:delete":"Delete todos (to History), delete them permanently and empty History","data:export":"Export your boards and todos","data:import":"Import boards and todos"}}}}}}}