Docs

These pages as Markdown, for software that reads documentation.

Every page on docs.duskstate.dev is also served by the API.

Index

GET /api/v1/docs returns every published page without its text, in navigation form:

{
  "data": [
    { "path": "api/errors", "title": "Errors", "description": "...", "section": null, "position": 21, "version": "api.errors-2026-10-06", "published_at": "2026-10-06T09:35:42.413Z" }
  ]
}

section names the sidebar heading a page starts; position orders siblings.

One page

GET /api/v1/docs/{path}, for example /api/v1/docs/api/errors, returns the same fields plus body, GitHub-flavoured Markdown. An unknown path returns 404. The rendered page is at https://docs.duskstate.dev/docs/{path}.

Freshness

Responses may be cached for up to 60 seconds. Pages are written and published by Dusk State staff; publishing a new version supersedes the previous one, which is kept on record.