Platform Partners
Platform partners manage multiple operators on OneHazel. This section covers the platform API for operator lifecycle management, catalog curation, and aggregated metrics.
Overview
As a platform partner, you can:
- Create and manage operators — Provision new operator accounts, manage their plans, and generate API keys on their behalf
- Curate the connector catalog — Control which connectors are visible to your operators
- Monitor metrics — View aggregated metrics across all your operators, per-operator breakdowns, and connector adoption rates
- Generate billing reports — Export usage data for invoicing
Authentication
Platform API endpoints require a platform API key:
Authorization: Bearer oh_platform_...Platform keys are distinct from operator keys (oh_live_...) and grant access to multi-tenant management endpoints.
Base URL
https://api.onehazel.com/platform-apiAPI endpoints
| Method | Path | Description |
|---|---|---|
POST | /operators | Create a new operator |
GET | /operators | List all operators |
GET | /operators/:id | Get operator details |
PUT | /operators/:id | Update operator (plan, status) |
DELETE | /operators/:id | Suspend an operator |
POST | /operators/:id/api-keys | Generate an API key for an operator |
GET | /operators/:id/api-keys | List an operator's keys (masked) |
DELETE | /operators/:id/api-keys/:keyId | Revoke an operator's key |
GET | /catalog | View the full marketplace catalog |
GET | /catalog/visibility | Get visibility rules |
PUT | /catalog/visibility | Update visibility rules |
GET | /metrics/summary | Aggregated platform metrics |
GET | /metrics/operators | Per-operator breakdown |
GET | /metrics/connectors | Connector adoption stats |
GET | /usage/report | Billing usage report |
GET | /settings | Platform profile |
PUT | /settings | Update platform profile |