What to upload
OpenAPI / Swagger specification (recommended)
OpenAPI / Swagger specification (recommended)
Accepted formats:
.json, .yaml, .ymlAn OpenAPI spec is the single most valuable thing you can provide beyond source code. It gives Mjolnir a complete, structured map of your API endpoints, request/response schemas, authentication requirements, and parameter types, without having to infer all of this from crawling.If you have one, upload it. If you have multiple (e.g. v2 and v3), upload both.Common locations in a project:openapi.json/openapi.yamlin the rootdocs/api.yaml- Auto-generated at
/api-docsor/swagger.jsonat runtime (export it and upload the file)
Architecture documentation
Architecture documentation
Accepted formats:
.pdf, .md, .txt, .docxAny documentation that describes your application’s architecture, data flows, or infrastructure topology. This helps Mjolnir understand the relationship between components, which is especially useful for microservice architectures where the attack surface spans multiple services.User role definitions / permission matrix
User role definitions / permission matrix
Accepted formats:
.json, .yaml, .pdf, .mdA description of your application’s roles and what each one can and cannot do. This directly improves the quality of privilege escalation tests. Mjolnir can check whether every boundary in your permission model is actually enforced.Examples:- A table showing which roles can access which endpoints
- A RBAC/ABAC configuration file
- A narrative description of your permission model
User journeys / workflows
User journeys / workflows
Accepted formats:
.pdf, .png, .mdDescriptions or diagrams of the key user flows in your application: signup, checkout, approval workflows, data export, etc. This helps Mjolnir prioritise which flows carry the most business risk.Other
Other
Anything else you think would help. When in doubt, include it. Mjolnir will use what’s relevant and ignore what isn’t.
Upload instructions
Drag and drop files onto the upload area, or click to open a file picker. Each uploaded file will show its name, detected type, and file size. You can remove any file before proceeding.Next: Domain Verification
Verify you own the domains you’re testing