# 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

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

## Sections

- [Operators](/platform/operators) — Creating, managing, and suspending operators
- [Catalog](/platform/catalog) — Curating the connector marketplace
- [Metrics](/platform/metrics) — Monitoring platform performance and billing