OpenAPI & client generation

Sumble doesn't publish a first-party SDK. Instead, the API is fully described by an OpenAPI 3 spec, so you can generate a typed client in your language of choice.

Spec URL

The spec is published and versioned:

https://api.sumble.com/openapi.json?version=v9

You can also browse it interactively in Swagger UI.

Generate a client

OpenAPI Generator is the most widely used generator and supports most languages. For example, to generate a Python client:

openapi-generator-cli generate \
  -i "https://api.sumble.com/openapi.json?version=v9" \
  -g python \
  -o ./sumble-client

Swap -g python for typescript, go, java, csharp, or any other supported generator.

Whatever client you generate, authenticate by passing your API key as a Bearer token. See the Overview for details.