Discovery files

The files an agent or crawler can read to learn what Dusk State offers.

All files are served from https://duskstate.dev without authentication.

Start here

FilePurpose
/.well-known/dusk-state.jsonPublisher identity, contacts, API version and links to every file below
/capabilities.jsonCapabilities that work now, with endpoint, method and authentication
/openapi.jsonOpenAPI 3.1 description of the public API
/.well-known/api-catalogAPI catalogue (RFC 9727) linking the OpenAPI description, these docs, the API policy and status

A client that reads only /.well-known/dusk-state.json can reach everything else from its links.

In this section