Platform Partners

Platform partners manage multiple operators on OneHazel. This section covers the platform application programming interface (API) for operator lifecycle management, catalogue 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 catalogue: 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-api

API 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 catalogue
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

Sections

• Operators: Creating, managing, and suspending operators
• Catalogue: Curating the connector marketplace
• Metrics: Monitoring platform performance and billing