Developer Portal — Blue Helm Studios

DEVELOPER PORTAL — BLUE HELM STUDIOS

Build on the
Blue Helm
Platform

Access the full Blue Helm Studios API suite. Connect your applications to KIPCHIT, Blue Helm Games, Blue Helm Systems, and the entire ecosystem through a single unified developer interface.

Get Started → Browse Endpoints

Your API Keys

Manage authentication tokens for all Blue Helm Studios services. Keep secret keys private and never expose them in client-side code.

Active Keys

Last rotated 14 days ago

Production Key bhs_live_••••••••••••••••••••••••••••••••4f9a PROD

Development Key bhs_test_••••••••••••••••••••••••••••••••2c31 DEV

Webhook Secret whsec_••••••••••••••••••••••••••••••••7d82 WEBHOOK

Quickstart

Get up and running with the Blue Helm Studios API in under two minutes. Choose your language below.

# Authenticate and fetch your profile
curl -X GET https://api.bluehelmstudios.com/v1/me \
  -H "Authorization: Bearer bhs_live_sk_YOUR_KEY" \
  -H "Content-Type: application/json"

# Response
{
  "id": "usr_4da3ff92",
  "email": "dev@yourcompany.com",
  "tier": "pro",
  "services": ["kipchit", "games", "systems"],
  "rate_limit": 5000
}

import { BlueHelm } from '@bluehelmstudios/sdk';

const client = new BlueHelm({
  apiKey: process.env.BHS_API_KEY,
  environment: 'production'
});

const me = await client.users.me();
console.log(me.id, me.tier);

// Access KIPCHIT services
const apps = await client.kipchit.apps.list({
  limit: 20,
  status: 'active'
});

from bluehelmstudios import BlueHelm
import os

client = BlueHelm(
    api_key=os.environ["BHS_API_KEY"],
    environment="production"
)

me = client.users.me()
print(f"Hello {me.email}, tier: {me.tier}")

# List game sessions
sessions = client.games.sessions.list(
    status="active",
    limit=50
)

import (
    "github.com/bluehelmstudios/sdk-go"
    "os"
)

client := bluehelmstudios.NewClient(
    os.Getenv("BHS_API_KEY"),
)

me, err := client.Users.Me(ctx)
if err != nil {
    log.Fatal(err)
}

fmt.Printf("Authenticated as: %s\n", me.Email)

use bluehelmstudios::{Client, Environment};

let client = Client::new(
    std::env::var("BHS_API_KEY")?,
    Environment::Production,
);

let me = client.users().me().await?;
println!("Tier: {}", me.tier);

let systems = client.systems()
    .infrastructure()
    .list().await?;

Core Endpoints

The Blue Helm API is organized around REST principles. All requests must be authenticated with your API key.

GET /v1/me

Returns the authenticated developer profile, assigned tier, active services, and rate limit information.

{
  "id": "usr_4da3ff92",
  "tier": "pro",
  "rate_limit": 5000,
  "services": ["kipchit"]
}

POST /v1/kipchit/sessions

Creates a new authenticated KIPCHIT session for a given user. Returns a short-lived session token.

{
  "user_id": "uid_8b2c",
  "expires_in": 3600,
  "token": "kpc_sess_••••"
}

GET /v1/games/sessions

Lists active multiplayer game sessions across Blue Helm Games infrastructure. Filterable by status and region.

{
  "sessions": [{
    "id": "sess_9f3d",
    "players": 12,
    "region": "us-west"
  }]
}

POST /v1/systems/deploy

Triggers a deployment on Blue Helm Systems infrastructure. Supply a service name, region, and config payload.

{
  "deploy_id": "dep_7c12",
  "status": "queued",
  "eta_ms": 4200
}

PATCH /v1/users/:id

Updates metadata fields on a user object. Supports partial updates via standard JSON merge patch semantics.

{
  "id": "usr_4da3ff92",
  "updated": true,
  "fields": ["display_name"]
}

DELETE /v1/keys/:id

Permanently revokes an API key. This action is irreversible. All requests using the revoked key will return 401.

{
  "id": "key_3bc1",
  "revoked": true,
  "revoked_at": "2026-05-11T..."
}

Official SDKs

First-party libraries maintained by Blue Helm Studios with full API coverage and automatic updates.

JavaScript / TypeScript

Full TypeScript support, browser & Node.js compatible, tree-shakable.

v3.4.1 — npm install @bluehelmstudios/sdk

Python

Sync & async support via httpx. Works with Python 3.9+.

v2.8.0 — pip install bluehelmstudios

Go

Idiomatic Go client with context support and full error typing.

v1.6.2 — go get github.com/bluehelmstudios/sdk-go

Rust

Async-first using Tokio. Zero-cost abstractions over the HTTP layer.

v0.9.4 — cargo add bluehelmstudios

Ruby

Faraday-based client with Sorbet type signatures included.

v2.1.0 — gem install bluehelmstudios

PHP

PSR-18 compatible HTTP client, supports Laravel & Symfony.

v1.3.5 — composer require bluehelmstudios/sdk

Rate Limits & Plans

All requests are rate-limited per API key. Limits reset on a rolling 60-second window.

Plan	Requests / min	Requests / day	Webhooks	Services
Free	60	10,000	3	KIPCHIT only
Pro	5,000	2,000,000	50	All services
Enterprise	Unlimited	Unlimited	Unlimited	All + private infra

Webhook Configuration

Subscribe to real-time events across the Blue Helm Studios ecosystem. All payloads are signed with your webhook secret.

Endpoint URL

Events to subscribe

User created user.created Session started session.start Deployment complete deploy.done Payment processed payment.success API key revoked key.revoked

PAYLOAD PREVIEW { "id": "evt_9a3c1f", "event": "user.created", "timestamp": "2026-05-11T...", "endpoint": "https://...", "data": { "user_id": "usr_4da3ff92", "email": "new@user.com" }, "signature": "sha256=••••••" }

Build on theBlue HelmPlatform