The SDKs are generated from the same openapi.json that powers this reference. They use Authorization: Bearer $OCTOSPARK_TOKEN and default to https://api.octospark.ai.

TypeScript

npm install @octospark/sdk
import { OctosparkApiError, OctosparkClient } from "@octospark/sdk"

const octospark = new OctosparkClient({
  token: process.env.OCTOSPARK_TOKEN
})

try {
  const organizations = await octospark.organizationsListOrganizations({
    query: { limit: 1 }
  }) as { data: Array<{ id: string; name?: string }> }

  console.log(organizations.data[0])
} catch (error) {
  if (error instanceof OctosparkApiError) {
    console.error(error.status, error.body)
  } else {
    throw error
  }
}
See Authentication, Get started, the organizations API reference, or the OpenAPI document.

Python

The Python SDK is generated in this docs repository and is currently in preview. The generated client uses the same bearer-token authentication model as the TypeScript SDK and defaults to https://api.octospark.ai.
import os
from octospark_sdk import OctosparkClient

octospark = OctosparkClient(token=os.environ["OCTOSPARK_TOKEN"])

organizations = octospark.organizations_list_organizations(
    query={"limit": 1}
)

print(organizations["data"][0])
Python package installation will be documented here once octospark-sdk is published to PyPI.