Start with code you can inspect.

Four small, real starter assets connect the public API contract to your server. No installer hides permissions, no file contains a key and no example claims production access.

API documentation Download OpenAPI 3.1 ↓

Starter assets

Download. Read. Then connect.

Every file is deliberately small enough for a complete review. Use the sandbox key only on the server.

TypeScript · 4 KB

TypeScript Sandbox Client

All nine operations, a stable error shape and request IDs. No dependencies.

Download asset

TypeScript · 2 KB

Webhook Verifier

HMAC-SHA-256, a time window and constant-time comparison over the raw body.

Download asset

JSON · 1 KB

Clarity Tool Starter

A valid C1 manifest with a native list interface and narrow profile.read scope.

Download asset

Markdown · 1 KB

Setup README

Server boundary, key management, validation and the exact next steps.

Download asset

Quickstart

One key. One observable request.

After approval, create a sandbox app, choose the smallest scope and store the key that is shown once in your server-side secret store.

Open the guided quickstart ›

server.ts

import { createClaritySandbox } from './clarity-sandbox-client';

const clarity = createClaritySandbox({
  apiKey: process.env.CLARITY_API_KEY!,
});

const status = await clarity.status();