Platform/Developers

Developer Platform

REST, GraphQL, webhooks, streaming, SDKs, OpenAPI, Postman, Terraform, CLI — scoped API keys with rotation and usage logs.

Public REST API

/api/v1

GraphQL API

/graphql

Webhook API

/api/v1/webhooks

Streaming API

wss://stream

OpenAPI specification

/openapi.json

Postman collection

/postman

API explorer

/developers/explorer

Terraform provider

registry.terraform.io/ziplyhuman

CLI

zhctl

API keys

Scoped permissions · workspace · environment · IP allowlist · expiry · rotation · last used · usage · revoke

Name	Prefix	Scopes	Env	IP	Last used	24h usage	Status
Production ingest	`zh_live_8f2a…`	events:write, calls:read	production	203.0.113.0/24	just now	48,210	active
Staging SDK	`zh_test_91bc…`	events:write, metrics:read	staging	any	just now	1,204	active
BI export	`zh_live_c0ff…`	exports:read, metrics:read	production	198.51.100.10	1d ago	44	active

Developer portal

Quick startAuthenticationCall ingestionEvent schemasTrace ingestionEvaluatorsMetricsAlertsIncidentsExportsWebhooksRate limitsError codesChangelogAPI status

Quick start

# Ingest event
curl -X POST https://human.ziply.my/api/v1/webhooks/events \
  -H "Authorization: Bearer zh_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"type":"call.completed","agent_id":"agt_01"}'

# Health
curl https://human.ziply.my/api/v1/health

# SDKs: TypeScript · Python · Go · Java · Terraform · zhctl CLI

TypeScript SDKPython SDKGo SDKTerraformzhctl CLI