Skip to content
For LLMsView as Markdown·

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-api

API endpoints

MethodPathDescription
POST/operatorsCreate a new operator
GET/operatorsList all operators
GET/operators/:idGet operator details
PUT/operators/:idUpdate operator (plan, status)
DELETE/operators/:idSuspend an operator
POST/operators/:id/api-keysGenerate an API key for an operator
GET/operators/:id/api-keysList an operator's keys (masked)
DELETE/operators/:id/api-keys/:keyIdRevoke an operator's key
GET/catalogView the full marketplace catalog
GET/catalog/visibilityGet visibility rules
PUT/catalog/visibilityUpdate visibility rules
GET/metrics/summaryAggregated platform metrics
GET/metrics/operatorsPer-operator breakdown
GET/metrics/connectorsConnector adoption stats
GET/usage/reportBilling usage report
GET/settingsPlatform profile
PUT/settingsUpdate platform profile

Sections

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