Home

sdkman-state

The SDKMAN! State API - the next-generation backend for managing SDK candidate versions, distributions, and vendor integrations.

For vendors

New here? Start with Vendor Onboarding - who qualifies, and how to get set up.

• Vendor Onboarding - who qualifies and how to get an account.
• Vendor API Integration Guide - authenticate (JWT) and publish versions, with curl and GitHub Actions examples.
• Well-formed SDK Archives - how to lay out your distribution archive.
• Platform and Distribution Reference - the accepted platform and distribution values.
• Tags, latest and default - how the default/stable version works.
• Migrating from the old Vendor API - if you used the old Consumer-Key API.

For community contributors

Not the vendor of an SDK, but want to add a candidate or publish new versions? Use sdkman-contrib: write one small YAML file with the contrib tool and open a pull request. Its README is the full guide. It replaces the retired sdkman-db-migrations repository.

API reference

• API Reference - endpoint overview, Swagger UI, and OpenAPI specification.

Quick Links

Resource	URL
Swagger UI	/swagger
OpenAPI Spec	/openapi/documentation.yaml
Source Code	github.com/sdkman/sdkman-state
SDKMAN! Website	sdkman.io
Discord	discord.gg/sdkman