Agent-ready API

Let your assistant
run it.

ChipClock is built so an agent acting on your behalf can sign up, configure a tournament, and run the clock — without you ever visiting the site. One request creates a trial org, a demo tournament, and an API key.

Create a trial org + demo tournament
curl -X POST https://chipclock.com/api/quickstart \
  -H "content-type: application/json" \
  -d '{"org_name":"Demo League"}'
One-request bootstrap
POST /api/quickstart returns a ghost-owned org, a demo tournament with the default blind structure, a clock row, and an ck_live_… Bearer key. No email confirmation. No checkout screen.
Scoped API keys
Each key is org-scoped and role-bounded. Quickstart keys are admin role. Rotate from the web UI when you convert the trial to a real account.
7-day trial TTL
Trial orgs auto-delete 7 days after creation. A daily cron sweeps expired trials and their ghost owners — no lingering data, no leaked credentials.

Start the clock next

The quickstart response includes org_slug, session_id, and api_key. Feed them straight into the clock endpoint:

Start the clock
curl -X POST https://chipclock.com/api/orgs/{org_slug}/clock \
  -H "Authorization: Bearer {api_key}" \
  -H "content-type: application/json" \
  -d '{"sessionId":"{session_id}","action":"start"}'

Mutations accept an Idempotency-Keyheader — retries with the same key within 24 hours replay the cached response, so network hiccups won't double-apply. Errors come back as a structured envelope with code, hint, and next_actions so the agent knows what to try next.

Want humans too?

The same org works for your players and your co-hosts. Every tournament has a phone companion, a QR check-in, and optional self-serve rebuys.