> ## Documentation Index
> Fetch the complete documentation index at: https://help.skillsdb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Client Libraries

> No official SDKs yet — generate a typed client from the OpenAPI document

<Info>
  **Quick Summary:** SkillsDB publishes no official SDKs today. The OpenAPI 3 document is built for client generation — download it from `/api/v1/openapi.json` and generate a typed client with the tool of your choice.
</Info>

## The contract is the SDK

The machine-readable contract behind these docs is an OpenAPI 3 document, downloadable without authentication:

```bash theme={null}
curl https://prod.skillsdbnext.com/api/v1/openapi.json -o skillsdb.openapi.json
```

It is client-generation-grade: every operation has a stable `operationId` (the method names a generator produces), and CI treats removing or renaming one as a breaking change that blocks the merge — inside v1 the contract only ever changes additively. A client you generate today keeps compiling against tomorrow's document.

## Generating a typed client

Any OpenAPI 3 generator works. For TypeScript, [openapi-typescript](https://github.com/openapi-ts/openapi-typescript) produces types with no runtime:

```bash theme={null}
npx openapi-typescript skillsdb.openapi.json -o skillsdb.d.ts
```

For a full client in most languages, [openapi-generator](https://openapi-generator.tech):

```bash theme={null}
npx @openapitools/openapi-generator-cli generate \
  -i skillsdb.openapi.json -g typescript-fetch -o ./skillsdb-client
```

Point the generated client's base URL at your environment and set the `Authorization: Bearer sdb_live_YOUR_KEY_HERE` header — see [Authentication](/api-docs/rest/authentication).

<Tip>
  **Tip:** Prefer exploring by hand first? The [Postman collection](/api-docs/rest/getting-started#explore-with-postman) is generated from the same contract.
</Tip>